本 书 是 一 本 很 受 欢 迎 的 技术 书 ， 从 第 1 版 到 第 5 版 ,虽然 书 名 和 编排 形式 略 有 调整 ， 但 是 Cookbook 这 个 特点 (EARBA (The Core iOS Developer s 
能 


Cookbook) ) 却 一 直 在 延续 。 

这 种 食谱 式 的 秘 记 手 册 之 所 以 受 欢 迎 ， 原 因 之 一 就 在 于 开发 者 非常 容易 通过 范例 来 学 习 一 | 门 语言 或 一 套 开发 环境 的 用 法 。 有 了 生动 易 懂 的 沁 例 ， 我 们 很 快 就 能 明 
白 如 何 制 作出 简单 实用 的 程序 。 再 经 过 反复 练习 ， 即 可 逐渐 掌握 开发 流程 。 
一 本 优秀 的 秘诀 手册 不 仅 要 涵盖 中 级 和 高 级 范例 ， 而 且 还 要 选择 有 代表 性 的 范 


另外 ， 秘 诀 手 册 与 普通 的 范例 教程 还 有 个 非 党 重要 的 区 别 ， 那 束 是 范例 的 选择 。 
例 ， 使 读者 在 学 会 该 范例 之 后 ， 能 够 根据 实际 需要 对 其 加 以 修改 ， 以 便 将 它 快速 整合 到 自己 的 程序 中 。 

从 上 述 两 方面 来 看 ， 本 书 都 极 好 地 体现 了 Cookbook 的 特点 。 作 者 根据 长 年 积累 的 开 友 经 验 ， 将 一 百 多 条 解决 方案 划分 为 IJOS 开 友 中 的 十 几 个 专题 ， 基 本 上 满足 了 
日 常 编程 的 需要 。 有 些 方案 讲 得 尤为 细致 ， 使 读者 可 以 看 到 如 何 按照 需 求 来 深度 定制 各 种 组 件 ， 比 如 第 6 曹 的 文本 编辑 器 和 第 7 章 的 自制 容器 等 。 除 了 冠 以 解决 方案 之 
名 的 范例 项 目 外 ， 还 有 一 些 以 程序 清单 形式 出 现 的 代码 片段 也 比较 实用 ， 每 段 代 码 都 相当 于 一 份 小 巧 的 模板 ， 演 示 了 某 些 对 象 或 技术 的 配置 方式 。 


很 多 都 与 图 形 界 面 及 手势 有 关 ， 这 对 于 提升 程序 流畅 度 和 用 户 体 验 大 有 好 处 。 作 者 还 提供 了 范例 项 目的 源 代码 。 对 于 较为 复杂 的 项 目 来 说 ， 
已 例 程序 ， 看 到 实际 效果 ， 然 后 再 与 书 中 各 步骤 详细 比 对 ， 以 了 解 整 个 流程 ， 也 可 以 自己 先 尝试 一 种 实现 方式 ， 然 后 与 作者 给 出 的 方案 或 其 他 教程 里 


综观 这 十 几 个 专题 ，; 
我 们 可 以 先 运 行 范 
给 出 的 方案 相 比 较 ， 看 看 有 何 异 同 ， 并 讨论 各 和 目的 优 缺 点 。 
里 说 本 书 所 举 的 范例 都 较为 浅显 直观 ， 但 读者 还 是 需要 了 略微 慌 一 些 Objective-C 语 言 和 iOS 开 发 的 基础 知识 。 如 果 你 是 新 手 ， 不 妨 先 参考 一 下 作者 在 前 言 里 所 推荐 
能 等 内 容 感 兴趣 ， 可 以 参考 与 这 些 主题 有 关 的 专车， 以 便 深入 研究 。 


的 几 本 入 门 书籍 。 此 外 ， 如 果 对 后 面 的 Core Data、 网 络 编程 、 设 备 适 配 及 辅助 功 
章 公 司 诸位 编辑 与 工作 人 员 的 帮助 ， 在 此 深 表 谢意 ， 并 感谢 goldlion 及 ChenGe 两 位 友人 对 术语 翻译 所 提 的 建议 。 


在 翻译 过 程 中 ， 得 到 机 械 工业 出 版 社 华章 公 
由 于 译 者 水 平 有 限 ， 错 误 与 下 C 漏 之 处 在 所 难免 ， 尽 请 各 位 读者 批评 指正 。 可 发 邮件 至 eastarstormlee@gmail.com 与 我 联系 ， 也 可 访问 网 


页 https://github.com/jeffreybaoshenlee/zh-translation-errata-cidc5/issues 留 言 


欢迎 阅读 本 书 新 版 ! 


目 苹 果 公 司 发 行 iOS 移 动 操作 系统 以 来 ，iOS 7 的 变革 是 最 为 重大 的 。 这 本 教程 将 会 指导 各 位 开发 者 针对 这 个 新 友 布 的 优秀 操作 系统 来 制作 应 用 程序 。2013 年 的 全 
PREF RB ES (Worldwide Developers Conference, WWDC) 公布 了 一 些 新 的 特性 和 视 完 范式 ， 而 本 书 这 次 修订 已 经 将 它们 全 都 涵 苹 在 内 了 ， 笔 者 将 会 向 你 


演示 如 何 将 其 融入 自己 的 应 用 程序 里 。 
皮 行 团队 将 这 次 修订 过 的 Cookbook 材 料 分 成 两 本 书 来 印刷 ， 以 控制 每 本 书 的 篇 幅 。 本 书 的 英文 书 名 叫 作 《The Core iOS Developer s Cookbook) , 讲述 了 
日 弟 开 友 所 需 的 关键 知识 ， 介 绍 了 使 用 标准 AP 与 界面 元 件 来 创建 IOs 应 用 程序 时 所 需 用 到 的 类 。 同 时 ， 本 书 以 “解决 方案 ”的 形式 讲解 创建 移动 应 用 程序 时 所 需 的 图 


像 、 触 措 及 视图 等 技术 。 
另外 一 本 书 的 英文 名 叫 作 《Learning iOS Development: A Hands-on Guide to the Fundamentals of iOS Programming》， 其 中 包含 了 一 些 入 门 知识 ， 相 
当 于 老 版 本 Cookbook 的 前 面 几 章 。 该 书 适合 想 要 从 头 学 习 iOS 7 基础 知识 的 开 上 友 者 阅读 。《Learning iOS Development) 讲述 了 Objective-C 编 程 语 言 、Xcode 开 发 


环境 以 及 与 调试 和 部 署 有 天 的 内 容 ， 你 可 以 通过 它 学 会 如 何 使 用 苹果 公司 的 开 友 工具 套件 。 


学 习 本 书 所 需 的 材料 和 知识 
想 开 发 OS 应 用 程序 ， 肯 定 得 有 一 台 测 试 应 用 程序 用 的 10S 设备 ， 而 且 最 好 是 一 台新 款 的 iPhone 或 iPad。 下 面 列 出 阅读 本 书 所 需 的 材料 和 基础 知识 


. 苹果 公司 的 IOS SDK 你 可 以 从 革 果 公司 的 OS Dev Center (http:/ /developer.apple.com/ios) 下 载 最 新 版 的 OS SDK。 如 果 打 算 在 App Store LAE A FLA, AR 


Lb 
么 还 必须 成 为 付费 的 iDS 开 发 者 。 个 人 开发 者 每 年 需要 付款 99 美 元 ， 企 业 开发 者 每 年 需要 付款 299 美 元 。 注 册 成 为 付费 开发 者 之 后 ， 就 会 收 到 一 份 证 书 ， 开 发 者 可 以 用 
这 份 证 书 来 签署 应 用 程序 ， 并 将 其 下 载 到 iPhone、iPod touch 或 iPad 中 进行 测试 与 调试 ， 此 外 ， 付 费 开 发 者 还 可 以 提前 获得 预览 版 的 OS 系统 。 未 付费 的 开发 者 可 以 在 


Mac 系 统 的 模拟 器 上 测试 软件 ， 但 是 不 能 将 其 部 署 到 设备 中 ， 也 不 能 将 其 提交 到 App Store. 
. 运行 Mac OS X Mountain Lion (v 10.8) 系统 的 新 款 Mac， 如 果 装 的 是 Mac OS X Mavericks (v 10.9) 系统 就 更 好 一 一 你 需要 为 软件 开发 留 出 足够 的 磁盘 空 


间 ， 而 且 应 该 尽 可 能 把 Mac 的 RAM 装 配 得 大 一 些 。 


iOS 设备 一 一 尽管 IOS SDK 里 的 模拟 器 也 能 用 来 测试 应 用 程序 ， 但 是 开发 者 仍然 需要 一 人 台 iOS 硬 件 设备 ， 以 便 针 对 iOS 平 台 做 开发 。 你 可 以 把 OS 设备 与 电脑 相 
连 ， 并 把 自己 构建 的 软件 装 上 去 。 在 开发 真实 的 App Store 程 序 时 ， 应 该 准备 数 款 硬件 和 固件 各 不 相同 的 设备 ， 以 便 在 目标 用 户 可 能 会 用 到 的 各 种 平台 上 进行 测试 。 


- 因特网 连接 一 一 连 上 网 之 后 ， 就 可 以 测试 应 用 程序 在 使 用 WiFi 和 使 用 移动 数据 网 络 时 的 效果 了 。 


- 熟悉 Objective-C 一 一 要 想 编写 iPhone 程 序 ， 需 要 了 解 Objective-C 2.0。 这 是 一 门 基于 ANSI C 的 语言 ， 并 且 带 有 面向 对 象 扩 展 ， 也 就 是 说 ， 你 需要 了 解 一 点 C 语 言 


Fyn 


的 知识 。 如 果 原 来 用 Java 或 C++ 写 过 程序 ， 而 且 又 熟悉 C 语 言 ， 那 么 应 该 能 够 迅速 适应 Objective-C。 


学 习 Mac/iOS 开 发 的 路 线 图 


一 本 书 不 可 能 把 各 类 读者 所 需 的 全 部 知识 都 虐 括 其 中 。 假 如 两 位 作者 把 你 所 需 的 全 部 内 容 都 写 到 这 本 书 里 ， 那 它 会 重 到 根本 拿 不 起 来 。 实 际 上 ， 想 要 开发 Mac 及 
iOs 平 台 上 的 程序 ， 需 要 学 习 很 多 内 容 。 如 果 你 刚 处 于 起 步 阶段 ， 而 且 没有 写 过 程序 ， 那 么 首先 应 该 学 习 一 门 大 学 水 平 的 C 语 言 课程 。 大 部 分 编程 语言 都 以 C 语 言 为 根 
基 ， 对 于 想 要 成 为 开 友 者 的 人 来 说 ， 目 然 也 要 从 C 语 言 学 起 。 


学 会 C 语 言及 编译 器 (基础 的 C 语 言 课程 会 讲 到 它 ) 的 用 法 之 后 ， 剩 下 的 事情 就 简单 多 了 。 此 时 可 以 直接 跳 到 Objective-C 语 言 ， 学 习 如 何 用 它 来 编程 ， 同 时 还 可 
以 学 习 Cocoa 框 架 。 图 1 是 一 张 流程 图 ， 里 面 列 出 了 培 生 教育 出 版 集团 所 出 版 的 一 些 关 键 书籍 (1]， 它 们 可 以 帮助 你 成 为 一 名 熟练 的 iOS 开 发 者 。 


了 解 C 语 言 之 后 ， 就 可 以 通过 多 种 方式 来 学 习 Objective-C 编 程 了 。 如 果 想 深入 了 解 Objective-C， 那 么 可 以 阅读 苹果 公司 自 编 的 文档 ， 也 可 以 翻 看 下 列 Objective- 
C 教 材 : 


* «Objective-C Programming: The Big Nerd Ranch Guide》， 第 2 版 ，Aaton Hillegass 与 Mikey Watd 著 (Big Nerd Ranch，2013 年 ) 
* «Learning Objective-C 2.0: A Hands-on Guide to Objective-C for Mac and iOS Developers? ， 第 2 版 ，Robett Claif 著 (Addison-Wesley, 20124F) [2] 


* «Programming in Objective-C 2.0» , #6, Stephen Kochan# (Addison-Wesley, 20124F) [3] 
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Al 成 为 OS 开发 者 的 路 线 图 


学 会 编程 语言 之 后 ， 接 下 来 应 该 学 习 Cocoa (适用 于 Mac 开 发 ) Cocoa Touch (适用 于 iOS 开 发 ) 以 及 开发 工具 ， 这 个 开发 工具 指 的 就 是 Xcode。 这 一 阶段 也 有 
几 种 不 同 的 学 习 途 径 。 你 依然 可 以 在 苹果 Developer 查 阅 苹果 公司 自 编 的 Cocoa、Cocoa Touch 及 Xcode 文档 (网 址 是 : developer.apple.com) ， 也 可 以 通过 阅读 书 
籍 来 学 习 它 们 。 笔 者 推荐 两 本 经 典 的 教材 : (iOS Programming: The Big Nerd Ranch Guide》 第 2 版 与 《Cocoa Programming for Mac OS X》 第 4 版 是， 前 者 是 
Aaron Hillegass 与 人 合 著 的 ， 后 者 是 他 自己 写 的 ，Aaron Hillegass 是 美国 亚特兰大 Big Nerd Ranch 公 司 的 创始 人 。Mac 开 上 友 圈 内 的 人 士 非常 欣赏 Aaron 所 写 的 书 ， 
而 且 cocoa-dev 邮 件 列表 中 里面 的 人 也 最 爱 推 荐 他 的 书 。 


Qi 市 面 上 还 有 非常 多 的 书籍 可 供 选 择 ， 包 括 由 Dave Mark. Jack Nutting, Jeff LaMarche &Fredrik Olsson 9p # 89 144 7 “Beginning iOS 6Development» 
(Apress, 20114E) 。 如 果 你 完全 是 个 编程 新 手 ， 那 么 可 以 看 看 Tim Isted 写 的 《Beginning Mac Programming? (Pragmatic Progtammets，2011 年 ) 。 不 要 只 看 一 本 书 ， 也 
不 要 只 看 一 家 出 版 社 的 书 。 和 不 同 的 开发 者 交流 ， 可 以 学 到 更 多 的 知识 ， 同 理 ， 通 过 阅读 多 本 书籍 ， 你 也 可 以 学 到 更 多 的 技巧 和 窍门 。 


若 想 真正 掌握 Mac 或 'OS 开 发 ， 还 需 通过 各 种 渠道 学 习 : 看 书 、 看 博客 、 看 邮件 列表 、 看 苹果 公司 自 编 的 开发 文档 ， 而 且 最 好 能 参加 开发 者 会 议 。 如 果 有 机 会 参与 
WWDC 的 话 ， 你 就 会 明白 开发 者 都 在 讨论 些 什 么 内 容 。 对 于 真正 想 学 好 编程 的 开发 者 来 说 ， 在 开发 者 会 议 上 花 些 时 间 和 别人 交流 是 件 非 常 值得 的 事情 (在 参加 WWDC 
时 ， 请 和 苹果 公司 的 工程 师 交 流 一 下 ) 。 


本 书 结构 


本 书 以 解决 方案 的 形式 逐个 讲解 OS 开 友 新 手 经 常 遇 到 的 各 种 问题 ， 比 方 说 : 排 布 界面 元 件 、 响 应 用 户 、 访 问 本 地 数据 源 、 连 接 Internet 等 。 相 关 的 一 组 任务 会 ) 
到 同一 章 里 面 ， 这 样 读 者 残 可 以 直接 找到 问题 的 解决 办 法 ， 而 不 用 再 去 想 解决 该 问题 所 需 使 用 的 类 或 框 以 了 。 


本 书 范 例 代 码 可 供 你 随手 剪 切 并 粘贴 ， 也 束 是 说 ， 书 中 每 个 解决 方案 里 面 的 源 代码 都 可 以 复 用 到 你 自己 的 应 用 程序 里 ， 你 只 需 按 照 自己 程序 的 需求 来 调整 即 可 。 


. 第 1 章 ， 手 势 与 触摸 一 一 在 OS 程序 中 ， 触 摸 是 一 种 非常 重要 的 手段 ， 用 户 可 以 由 此 来 传达 对 应 用 程序 所 做 的 操作 。 触 摸 并 不 局 限于 按 下 按钮 及 通过 键盘 交互 这 


两 种 行为 。 本 章 将 介绍 直接 操纵 界面 、 多 点 触摸 以 及 其 他 一 些 内 容 。 你 将 会 学 到 如 何 创 建 这 样 一 种 视图 : 用 户 可 以 在 屏幕 上 试验 各 种 手势 ， 并 看 到 不 同 手势 之 间 的 区 
别 。 另 外 ， 本 章 还 会 告诉 你 如 何 创 建 自 定义 的 手势 识别 器 。 


` 第 2 章 ， 构 建 并 使 用 控件 一 一 本 章 将 深入 讲解 如 何 操控 应 用 程序 。 你 将 会 详细 了 解 控件 的 运作 机 制 ， 还 能 学 会 以 多 种 方式 来 构建 并 自 定义 控件 。 这 一 章 包 含 很 多 
解决 方案 ， 有 的 比较 简单 ， 有 的 比较 复杂 ， 你 可 以 把 它们 复 用 到 自己 的 程序 里 。 


. 第 3 章 ， 提 醒 用 户 iOS 提 供 了 多 种 在 屏幕 上 向 用 户 显示 信息 的 方式 ， 比 如 弹出 式 对 话 框 、 进 度 条 、 本 机 通知 (local notification) ~ popoverfeaudio ping 等 。 本 
章 将 会 讲解 如 何在 应 用 程序 中 实现 这 些 信息 通知 手段 ， 以 帮助 读者 用 更 多 的 方式 向 用 户 显 示人 信息。 本 章 将 介绍 这 些 类 的 基本 使 用 方法 ， 田 外 还 会 提供 一 些 解决 方案 ， 


使 你 可 以 通过 基于 块 的 API (blocks-based API) 来 轻松 地 处 理 与 警示 信息 有 关 的 交互 操作 。 


.第 4 章 ， 编 排 视图 及 其 动画 效果 一 一 UIView 类 及 其 子 类 可 用 来 填充 iDS 设 备 的 屏幕 。 本 章 将 会 从 头 开始 讲解 视图 。 与 视图 有 关 的 解决 方案 会 分 别 演 示 如 何 获取 视 
图 对 象 、 如 何 制作 视图 的 动画 效果 以 及 如 何 操纵 视图 对 象 。 你 将 会 学 到 怎样 构建 、 检 视 及 分 解 视图 层级 ， 并 了 解 多 个 视图 是 如 何 组 织 起 来 的 。 通 过 学 习 本 章 ， 你 会 发 
现在 图 形 界 面 中 创建 并 摆 放 视图 的 时 候 ， 视 图 位 置 的 排 布 是 非常 重要 的 ， 另 外 ， 你 还 会 学 到 如 何 制作 视图 在 屏幕 上 移动 和 切换 时 所 具备 的 动画 效果 。 


. 第 5 章 ， 视 图 的 约束 系统 一 一 Auto Layout 机 制 彻 底 改 变 了 iOS 程 序 里 视图 的 排 布 方式 。 革 果 公司 的 这 种 布局 特性 使 开发 者 可 以 轻松 地 设计 出 更 为 协调 一 致 的 界 
面 。 此 特性 对 于 同一 系列 不 同 屏幕 大 小 、 不 同 界面 、 不 同 屏幕 方向 、 不 同 语言 的 设备 来 说 尤为 重要 。 本 章 将 会 介绍 如 何 用 代码 来 做 视图 约束 方面 的 开发 。 你 会 学 到 怎 
样 在 屏幕 上 的 物件 之 间 创 建 关 系 以 及 怎样 指定 布局 规则 ， 使 iDS 能 够 自动 排 布 应 用 程序 中 的 视图 。 看 完 本 章 后 ， 你 就 能 设 定 一 套 健全 的 屏幕 布局 规则 了 。 


: 第 6 章 ， 文 本 输入 一 一 本 章 的 解决 方案 都 与 文本 有 关 ， 这 些 解决 方案 能 够 解决 许多 问题 。 你 会 学 到 如 何 控制 键盘 、 如 何 使 屏幕 上 面 的 控件 支持 文本 输入 、 如 何 扫 
描 文本 、 如 何 格式 化 文本 ， 等 等 。 这 一 章 会 把 与 OS 程序 文本 处 理 有 关 的 各 项 技术 都 涵盖 在 内 ， 包 括 文本 框 、 文 本 视图 以 及 iOS 内 置 的 拼写 检查 器 。 


. 第 7 章 ， 使 用 视图 控制 器 一 一 本 章 将 会 讲解 各 种 视图 控制 器 类 的 用 法 ， 这 些 类 使 得 用 户 可 以 在 更 大 的 范围 中 与 应 用 程序 交互 ， 而 开发 者 也 可 以 借 此 来 排 布 视图 。 


你 将 通过 本 草 的 各 解决 方案 学 到 页 面 视图 控制 器 、 分 栏 视图 控制 器 、 时 航 控 制 器 等 视图 控制 器 的 用 法 。 


` 第 8 章 ， 常 用 的 控制 器 一 一 -OS SDK 里 面 有 很 多 系统 自 带 的 控制 器 ， 开 发 者 可 以 用 它们 来 完成 日 常 的 开发 任务 。 本 章 将 介绍 最 为 常用 的 控制 器 。 你 会 学 到 如 何 从 
照片 库 中 选取 照片 、 如 何 拍照 、 如 何 录 制 并 编辑 视频 。 另 外 ， 你 还 会 学 到 如 何在 程序 中 编写 电子 邮件 及 文本 消息 ， 以 及 如 何在 Twitter 及 Facebook 等 社交 媒体 上 张贴 信 


自 


INO 


. 第 9 章 ， 创 建 并 管理 表格 视图 -表格 (table) 是 一 种 可 以 滚动 的 交互 类 ， 它 在 屏幕 较 小 的 设备 上 面 效果 很 好 ， 在 屏幕 较 大 的 平板 电脑 上 面 效果 也 很 不 错 。 由 于 
表格 可 以 把 内 容 以 一 种 简单 而 自然 的 方式 组 织 起 来 ， 所 以 很 多 iOS 应 用 程序 都 是 以 表格 为 中 心 的 。 本 章 将 介绍 表格 的 用 法 ， 解 释 表 格 的 工作 原理 ， 讲 解 可 供 开 发 者 使 用 
的 各 种 表格 ， 并 且 告诉 你 如 何在 程序 中 利用 表格 的 各 种 特性 。 


` 第 10 章 ， 集 合 视 图 一 一 集合 (collection) 视图 的 许多 概念 都 与 表格 相同 ， 但 是 功能 更 加 强大 ， 而 且 更 加 灵活 。 本 章 将 会 讲述 使 用 集合 视图 所 需 的 各 种 基础 知识 ， 
包括 如 何 创建 可 以 横向 滚动 的 列表 、 如 何 创 建 网 格 布局 、 如 何 创建 圆 形 等 特殊 方式 的 布局 ， 等 等 。 你 将 学 到 怎样 通过 布局 规格 (layout specification) 把 视觉 效果 集成 到 
集合 视图 里 面 ， 以 及 怎样 使 集合 视图 中 的 内 容 在 滚动 之 后 自动 调整 位 置 ， 另 外 ， 你 还 会 学 到 如 何 利 用 内 置 的 动画 支持 来 创建 出 最 有 效 的 互动 效果 。 


` 第 11 章 ， 分 享 文档 与 数据 一 一 在 OS 系统 中 ， 应 用 程序 可 以 分 享 信息 和 数据 ， 另 外 ， 开 发 者 也 可 以 使 用 系统 所 提供 的 许多 特性 ， 把 控制 权 从 一 个 程序 转移 到 另 一 
个 程序 。 你 可 以 用 本 章 所 介绍 的 几 种 方式 在 应 用 程序 之 间 分 享 文档 及 数据 。 你 将 学 到 如 何 把 这 些 特性 添加 到 自己 的 应 用 程序 之 中 ， 以 及 如 何 灵 巧 地 使 用 分 享 功能 ， 令 
自己 的 应 用 程序 可 以 和 iOS 生 态 系 统 里 的 其 他 程序 协同 运作 。 


- 第 12 章 ， 浅 谈 Core Data—— Core Data 提 供 了 一 套 受 托管 的 数据 存储 机 制 ， 使 开发 者 可 以 在 应 用 程序 中 查询 并 更 新 存储 区 里 的 数据 。 它 提供 了 一 套 基于 Cocoa 
Touch 的 对 象 接口 ， 使 得 OS 开发 者 能 够 像 使 用 SQL 查 询 语句 那样 ， 通 过 Objective-C 代 码 来 管理 关系 型 数据 库 中 的 数据 。 本 章 介 绍 Core Data。 通 过 其 中 的 各 解决 方案 ， 你 
可 以 初步 了 解 这 项 技术 ， 同 时 还 能 以 本 章 内 容 为 出 发 点 ， 继 续 深 入 学 习 Cote Data。 你 将 学 到 如 何 设计 受托 管 的 数据 库存 储 机 制 、 如 何 添加 和 删除 数据 、 如 何 用 代码 查 


询 数 据 ， 以 及 如 何 把 这 些 操作 同 UIKit 中 的 表格 视图 及 集合 视图 相 集 成 。 


第 13 章 ， 网 络 编程 基础 一 一 在 连接 到 Intetnet 的 设备 上 面 ， 特 别 适合 用 iOS 程 序 来 订阅 基于 网 络 的 服务 。 革 果 公 司 为 iDS 平 台 提供 了 各 种 坚实 的 网 络 计算 服务 及 支 
持 技 术 。 本 章 将 介绍 网 络 编程 中 的 常用 技术 ， 同 时 也 提供 一 些 解决 方案 ， 用 来 简化 日 常 的 网 络 开发 任务 。 本 章 介绍 iDS 7 新 引入 的 HTTP 系 统 ， 并 且 提 供 实现 数据 下 载 功 
能 (包括 后 台 下 载 ) 所 用 的 一 些 范例 代码 。 你 还 会 学 到 如 何 判 断 网 络 是 否 可 用 ， 以 及 如 何 使 用 Web 服 务 ， 这 其 中 包含 了 一 些 范例 代码 ， 它 们 告诉 你 如 何 通 过 XML 解析 及 
JSON 序 列 化 来 访问 一 些 在 线 服务 。 


` 第 14 章 ， 针 对 特定 设备 的 开发 一 一 每 台 iOS 设 备 都 有 许多 属性 ， 有 些 属 性 是 该 设备 所 独 有 的 ， 而 有 些 则 是 许多 设备 所 共有 的 ;有 些 属性 是 持续 变化 的 ， 而 有 些 则 


保持 不 变 。 这 些 属性 包括 设备 当前 的 物理 方向 、 型 号 名 称 、 电 池 状 态 以 及 是 否 可 以 访问 机 体内 的 硬件 等 。 本 章 将 会 讲解 如 何 查看 设备 的 硬件 规格 ， 以 及 如 何 查看 设备 
中 可 供 使 用 的 感应 器 。 这 一 章 所 提供 的 解决 方案 可 用 来 查询 当前 设备 的 各 项 信息 。 

- 第 15 章 ， 辅 助 功 能 一 一 本 章 简单 地 介绍 VoiceOvef 这 项 辅助 功能 ， 开 发 者 可 以 通过 该 功能 尽量 扩大 应 用 程序 的 受众 。 你 将 学 到 如 何 为 应 用 程序 添加 与 辅助 功能 有 
关 的 标签 及 提示 ， 以 及 如 何在 模拟 器 和 iOS 设 备 中 测试 这 些 特性 。 


- 附录 A，Objective-C 字 面 量 一 一 本 附录 介绍 了 Objective-C 语 言 里 与 数字 、 数 组 及 字典 有 关 的 一 些 新 特性 。 


POPSET A 


为 了 大 家 学 起 来 方便 ， 本 书 的 范例 代码 只 使 用 一 个 main.m 文 件 。 编 写 iPhone 或 Cocoa 应 用 程序 时 ， 开 发 者 一 般 都 不 会 这 么 做 ， 而 且说 实在 的 ， 也 确实 不 应 该 这 么 
做 ， 但 是 ， 这 种 做 法 却 非常 适合 展示 一 个 大 的 概念 。 假 如 一 份 光 例 代码 分 成 5 个 、7 个 或 9 个 文件 ， 就 不 太 容易 讲述 这 个 概念 了 。 而 将 所 有 代码 都 写 到 一 个 文件 里 ， 则 有 
助 于 专门 把 这 个 概念 说 清楚 。 


书 中 的 范例 代码 不 应 该 当成 独立 的 应 用 程序 来 用 。 每 份 范例 代码 只 对 应 于 一 个 解决 方案 ， 而 且 只 演示 一 个 概念 。 每 个 main.m 文 件 都 是 专门 为 了 实现 某 个 中 心 概念 
而 编写 的 。 读 者 在 学 会 这 些 思路 之 后 ， 可 以 按照 平 单 开 友 时 所 用 的 文件 组 织 结构 及 布局 方式 将 其 转换 为 普通 的 应 用 程序 结构 。 本 书 所 用 的 代码 组 织 方 式 与 日 弟 开 友 中 
所 应 提倡 的 标准 组 织 方式 并 不 相符 。 笔 者 之 所 以 采用 这 种 方式 ， 是 为 了 提供 精确 的 解决 万 案 ， 而 大 家 可 以 根据 需求 把 它们 集成 到 目 己 的 工作 项 目 中 。 


苹果 公司 的 标准 范例 代码 与 本 书 不 同 ， 你 必须 查看 很 多 源 文件 ， 才 能 在 脑 中 构建 出 一 套 与 待 演示 的 构 仿 有关 的 “思维 模型 。。 那 些 范例 代码 都 是 完整 的 应 用 程 
序 ， 里 面 通常 会 涉及 一 些 与 当前 所 要 解决 的 问题 没有 关系 的 任务 。 我 们 必须 伦 很 大 精力 才能 找到 与 当前 问题 有 关 的 代码 ， 这 是 得 不 偿 失 的 。 


本 书 还 有 些 范 例 代码 没有 遵循 “一 个 文件 只 说 一 件 事 ” 的 规则 : 如 果菜 个 解决 方案 与 类 的 实现 有 关 ， 那 么 本 书 还 会 提供 标准 的 类 文件 及 头 文 件 。 有 些 解决 万 案 并 
不 是 为 了 强调 某 项 技术 ， 而 是 为 了 提供 某 些 类 及 category (category 是 一 种 针对 现 有 类 所 做 的 扩展 ， 它 不 产生 新 的 类 ) 的 实现 。 对 于 这 些 解 决 方案 来 说 ， 读 者 可 以 找 
到 单独 的 .m 与 .h 文 件 ， 而 main.m 文 件 里 面 则 封装 了 一 份 框架 代码 ， 用 来 摘 述 其 余 的 事情 。 


本 书 大 多 数 范例 代码 都 只 使 用 一 个 应 用 程序 标识 符 ， 也 就 是 com.sadun.helloworld。 只 使 用 一 个 标识 符 的 好 处 是 : 你 的 iOSs 设 备 里 不 会 装 很 多 范例 程序 。 每 安装 
一 个 范例 程序 ， 都 会 把 前 面 那个 替换 掉 ， 这 样 的 话 ， 设 备 的 主屏 幕 就 能 干净 一 些 。 如 果 需 要 同时 安装 多 个 范例 程序 ， 那 么 只 需 给 标识 符 加 个 后 缀 就 可 以 了 ， 例 如 
com.sadun.helloworld.table-edits。 如 果 想 令 多 个 应 用 程序 所 显示 出 来 的 名 称 各 不 相同 ， 那 么 可 以 编辑 自 定 义 的 显示 名 称 。 你 的 Team Provisioning Profile 能 够 匹配 
包括 com.sadun.helloworld 在 内 的 每 一 个 应 用 程序 标识 符 。 这 样 的 话 ， 无 须 修 改 标 识 符 ， 就 可 以 把 编译 后 的 代码 安装 到 设备 上 面 了 ， 只 是 记得 要 在 每 个 项 目的 Build 
Settings 中 更 新 Code Signing Identity, 


获取 范例 代码 
你 可 以 在 开源 项 目 托管 网 站 GitHub 中 找到 本 书 源 代码 : http://github.com/erica/iO0S-7-Cookbook。 每 一 章 的 源 代码 都 放 在 一 个 文件 夹 内 ， 其 中 包含 书 里 的 相 
天 范例 材料 。 解 决 方案 的 编号 与 其 在 书 中 的 编号 相同 。 比 方 说 ， 第 5 章 的 第 6 个 解决 方案 放 在 C05 文 件 夹 下 面 的 06 子 文件 夹 中 。 


以 00 为 编号 的 项 目 或 是 编号 市 有 后 缀 (例如 05b、02c) 的 项 目 是 为 了 便于 搜索 或 创建 插图 而 使 用 的 素材 。 比 方 说 ， 第 9 章 的 00-Cell Types 项 目 是 为 了 创建 图 9-2 
中 的 效果 而 编写 的 ， 那 张 图 用 来 演示 系统 所 提供 的 各 种 表格 视图 单元 格 样 式 。 一 般 情 况 下 ， 笔 者 会 把 这 些 多 余 的 项 目 删 挥 。 本 书 初 稿 的 读者 请 求 笔 者 把 它们 放 在 这 个 
版 本 中 。 整 个 代码 库 里 大 约 能 找到 六 七 个 这 样 的 范例 项 目 。 


为 本 书 出 力 


范例 代码 绝 不 是 一 成 不 变 的 ， 它 会 随 着 苹果 公司 的 SDK 与 Cocoa Touch 库 而 不 断 进化 。 请 各 位 读者 一 起 参与 这 个 过 程 。 你 可 以 提交 bug 修 复 和 修改 书 中 的 错误 ， 
也 可 以 扩充 现 有 的 代码 。 你 可 以 对 GitHub 代 码 库 做 分 支 (fork) ， 自 己 调整 代码 ， 实 现 一 些 功能 ， 然 后 再 分 享 回 主 代码 库 里 。 如 果 你 有 新 的 想法 或 思路 ， 请 告诉 我 
们 。 我 们 很 乐意 将 你 的 宝贵 建议 加 到 代码 库 中 ， 并 据 此 完善 本 书 的 下 一 个 版 本 。 


获取 git 工 具 


你 可 以 使 用 git 版 本 控制 系统 来 下 载 本 书 源 代码 。Xcode 5 集成 开 及 环境 提供 了 非常 健壮 的 git 广 持 。Xcode 5 工具 箱 里 面 也 包含 了 命令 行 式 的 git 工 具 。 此 外 ， 还 有 
大 量 的 第 三 方 及 商业 版 git 工 具 可 供 选 择 。 


使 用 GitHub 


GitHub (http://github.com/) 是 最 大 的 git 托 管 网 站 ， 有 超过 15 万 个 公开 的 代码 库 (repository) [Ql。 它 可 以 免费 托管 公开 项 目 ， 也 可 以 付费 托管 私有 项 目 。 该 
网 站 提供 了 一 套 可 以 自 定义 的 Web 界 面 ， 其 中 包含 Wiki 托 管 、 问 题 追踪 等 功能 ， 是 项 目 开发 者 之 间 的 一 个 优秀 的 社交 网 络 ， 开 发 者 可 以 在 这 里 寻找 新 代码 ， 也 可 以 协 
同 开发 既 有 的 程序 库 。 你 可 以 在 GitHub 网 站 注册 免费 账号 ， 注 册 好 之 后 ， 就 可 以 复制 并 修改 本 书 的 范例 代码 库 了 ， 另 外 ， 也 可 以 创建 自己 的 开源 iOS 项 目 ， 并 与 他 人 
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第 1 草 FSD 


触摸 是 iOS 交 互 的 核心 ， 它 提供 了 一 种 非常 关键 的 手段 ， 使 用 户 可 以 向 应 用 程序 表达 上 自己 的 意图 。 触 摸 并 不 局 限于 “ 按 下 按钮 ”或 “点 击 键盘 ”这 两 种 动作 。 你 可 
以 设计 并 构建 出 一 种 应 用 程序 ， 令 其 能 够 以 有 意义 的 方式 来 直接 处 理 用 户 的 手势 。 本 章 将 要 创建 一 套 “ 直 接 操纵 界面 ” (direct manipulation interface) ， 这 套 界面 
远 比 系统 内 置 的 控制 手段 强大 。 你 会 在 本 章 中 学 到 如 何 创建 一 种 可 供用 尸 在 屏幕 上 拖 蝶 的 视图 。 此 外 ， 还 会 学 到 怎样 用 手势 识别 器 类 来 分 辨 并 解析 手势 ， 手 势 是 对 解 
摸 的 一 种 高 级 抽象 方式 ， 而 手势 识别 器 类 则 可 以 上 自动 检测 常见 的 点 击 (tap) 、 滑 动 或 扫 屏 (swipe) At&B (drag) 等 手势 。 学 完 本 章 之 后 ， 你 束 可 以 在 自己 的 应 用 
程序 里 面 以 各 种 不 同 的 方式 来 实现 手势 控制 了 。 


1.1 触摸 


Cocoa Touch 以 最 简单 的 方式 实现 了 直接 操纵 ， 也 融 是 向 用 户 正 在 操作 的 视图 友 送 触 扣 事件 。iOSs 开 上 友 者 会 告诉 这 个 视图 应 该 如 何 啊 应 用 尸 。 在 开始 讲 手 势 和 手势 
识别 器 之 前 ， 首 先 应 该 牢固 地 掌握 底层 触摸 技术 。 因 为 所 有 基于 触摸 的 交互 操作 都 需要 使 用 由 底层 触摸 技术 所 提供 的 关键 组 件 。 


每 次 触摸 都 包含 下 列 信 息 : 触摸 操作 友 生 在 何 处 (当前 触摸 的 位 置 和 上 一 次 触摸 的 位 置 ) 、 触 摸 操作 位 于 哪个 阶段 (直接 操纵 界面 中 的 “ 按 下 ”、“ 移 动手 
所 ”及 “ 抬 起 手提 ” 分 别 相当 于 提 面 应 用 程序 里 的 “ 按 下 鼠标 按钮 ”、 “移动 鼠标 ”和 “ 松 开 鼠 标 按钮 ”) 、 点 击 的 次 数 (是 单 击 还 是 双击 ) 以 及 触摸 操作 友 生 的 时 
间 (以 时 间 戳 表示 ) 。 


iOS 使 用 响应 者 链 来 决定 应 该 由 哪个 对 象 处 理 触摸 。 顾 名 思 义 ， 响 应 者 融 是 响应 事件 的 对 象 ， 而 响应 者 链 则 是 一 条 由 可 以 处 理 这 种 事件 的 对 象 所 组 成 的 链 。 用 户 触 
操 屏 幕 时 ， 应 用 程序 会 找寻 相 天 对 象 来 处 理 此 操作 。 触 措 事 件 将 在 视 图 之 间 传 递 ， 直 到 某 个 对 象 开 始 负责 响应 该 事件 为 止 。 


从 根本 上 说 ， 每 个 触摸 操作 及 其 信息 都 保存 在 UITouch 对 象 里 面 ， 而 这 样 一 组 UITouch 则 放 在 UIEvent 对 象 里 面 传递 。 每 个 UIEvent 对 象 都 表示 一 次 触摸 事件 ， 其 
中 包含 一 个 或 多 个 UITouch。 具 体 数 量 是 多 少 取决 于 两 个 因素 : 一 是 开 友 者 设 定 应 用 程序 应 该 以 哪 种 方式 来 啊 应 触摸 (EME, AReSAH RSS RAR) ， 二 
是 用 户 如 何 触 摸 屏幕 (也 惑 是 实际 触 措 了 几 个 点 ) 。 


应 用 程序 会 在 视图 类 或 视图 控制 器 类 里 接收 到 触摸 事件 ， 而 这 两 种 类 都 继承 了 UIResponder 类 ， 于 是 也 就 自动 实现 了 触摸 处 理 程序 (touch handler) 。 开 发 者 可 
以 自己 决定 应 该 在 哪个 类 里 面 处 理 并 咽 应 触摸 事件 。 许 多 iOS 开 友 新 手 都 想 试 着 在 非 响应 者 类 里 实现 底层 的 手势 控制 ， 但 他 们 可 能 会 遇 到 麻烦 。 


在 视图 中 处 理 触 摸 事 件 似 乎 有 违 常理 。 你 可 能 觉得 应 该 把 界面 的 样 够 (也 就 是 视图 ) 与 它 响应 触摸 的 方式 (也 就 是 控制 器 ) 分 开 。 上 此外， 直接 用 视图 来 处 理 触 摸 
似乎 也 有 违 “ 模 型 -视图 -控制 器 ” (Model-View-Controller) 设计 规范 ， 不 过 ， 有 了 时候 这 人 么 做 还 是 必要 的 ， 而 且 可 以 提升 封装 程度 。 


我 们 有 时 要 面 对 多 个 能 够 响应 触摸 事件 的 子 视图 ， 比 方 说 在 棋 类 游戏 中 ， 棋 盘 上 的 棋子 束 是 如 此 。 如 果 和 直接 把 交互 行为 构建 在 视图 类 里 面 ， 那 么 开发 者 丈 能 够 在 
隐藏 实现 细节 的 前 提 下 ， 向 应 用 程序 的 核心 代码 友和 送 含义 丰富 的 反馈 信息 。 例 如 ， 开 发 者 可 以 在 玩家 结束 操作 之 后 告知 模型 : "R" (pawn) 移动 到 
了 “后” (Queen) 这 一 侧 “ 象 ” (Bishop) 列 的 第 5 格 ![]， 假 如 不 采取 这 种 响应 方式 ， 那 么 开发 者 就 要 传输 一 系列 没有 意义 的 坐标 变化 信息 了 。 响 应 触摸 事件 时 ， 
把 棋子 的 移动 细 世 隐藏 起 来 ， 融 可 以 用 棋 类 游戏 所 专 有 的 术语 来 编写 模型 部 分 的 代码 ， 而 不 用 再 考虑 棋子 在 视图 中 的 位 置 变 化 。 


选择 在 UIView 类 中 响应 触 拒 事件 的 另 一 个 原因 是 便于 绘制 。 如 果 想 令 应 用 程序 在 响应 用 户 的 触摸 时 处 理 绘制 操作 (drawing operation) ， 融 需要 把 触 措 处 理 程 
序 放 在 视图 中 实现 。 因 为 视图 控制 器 与 视图 不 同 ， 它 并 没有 实现 drawRect: 方法 ， 而 在 执行 自 定义 的 绘制 操作 时 ，drawRect: 却 是 个 至 关 重 要 的 方法 。 


在 UIViewController 类 里 响应 触摸 同样 有 其 优 点 。 这 样 做 的 好 处 是 ， 我 们 不 用 把 主要 的 事件 处 理 逻 辑 放 人 在 另 一 个 类 里 实现 ， 而 是 可 以 直接 把 管理 触摸 的 代码 放 和 在 
视图 控制 器 中 ， 以 便 在 需要 用 到 “ 按 住 不 放 ” (tap-and-hold) 及 “滑动 ”等 标准 手势 的 时 候 解 析 它 们 。 这 种 做 法 可 以 令 代码 保持 集中 ， 而 且 可 以 使 控制 器 能 够 直接 
和 应 用 程序 的 模型 交互 。 


在 后 续 的 数 节 及 解决 方案 里 面 ， 你 将 学 到 触摸 操作 的 工作 原理 、 如 何在 应 用 程序 里 响应 触摸 以 及 如 何 把 用 户 所 看 到 的 内 容 同 其 与 屏幕 的 交互 方式 联系 起 来 。 


1] 国际 象棋 步 法 的 描述 方式 请 参见 https://en.wikipedia.org/wiki/Descriptive_chess_notation。 


译 者 注 


1.1.1 触摸 操作 所 处 的 阶段 


触摸 有 其 生命 周期 。 每 个 触摸 操作 都 会 处 于 下 列 五 个 阶段 之 一 ， 而 这 五 个 阶段 合 起 来 融 代 表 了 界面 中 的 触摸 操作 所 历经 的 过 程 。 这 些 阶段 分 别 是 : 
- UITouchPhaseBegan 一 一 用 户 一 旦 触摸 屏幕 ， 即 进入 此 阶段 。 

- UITouchPhaseMoved 一 一 用 户 的 手指 在 屏幕 上 移动 。 

: UITouchPhasestationary 一 一 自 上 一 个 事件 发 生 之 后 ， 用 户 仍然 在 触摸 着 屏幕 表面 ， 但 却 没有 移动 。 


- UITouchPhaseEnded 一 一 当 用 户 把 触摸 屏幕 的 手指 从 屏幕 上 拿 开 之 后 ， 就 进入 了 这 个 阶段 。 


- UITouchpPhaseCancelled 一 一 如 果 iOS 系 统 不 再 追踪 某 个 触摸 操作 ， 那 么 就 会 进入 该 阶段 。 这 通常 是 因为 系统 中 断 而 导致 的 ， 比 方 说 ， 应 用 程序 不 再 处 于 活动 


状态 ， 或 相关 的 视图 已 经 从 视窗 里 移 走 。 


总 体 来 说 ， 用 这 五 个 阶段 就 可 以 描述 触摸 事件 了 。 它 们 描述 了 在 处 理 界面 中 的 触摸 操作 或 无 法 处 理 某 个 触摸 操作 时 所 能 遇 到 的 全 部 状况 ， 并 且 为 相关 界面 提供 了 
一 套 基本 的 控制 手段 。 至 于 如 何 解 析 并 响应 这 些 情况 ， 就 是 每 一 位 开发 者 的 事情 。 你 可 以 实现 一 系列 的 响应 者 方法 Li 来 响应 触摸 事件 。 


[1] 作者 把 UIResponder 类 里 面 与 处 理 触 摸 事 件 有 关 的 几 个 方法 叫 作 “响应 者 方法 ”或 “UIRespondet 方 法 ”， 下 同 。 译 者 注 


1.1.2. UlResponder 类 中 的 触摸 事件 响应 万 法 
包括 UlView 及 UIViewController 在 内 的 所 有 UIResponder 子 类 都 可 以 响应 触摸。 每 个 类 都 可 以 决定 自己 要 如 何 响应 。 决 定好 响应 方式 之 后 ， 就 可 以 在 类 中 实现 自 
定义 的 行为 了 ， 而 当 用 户 拿 一 个 或 多 个 手指 触摸 视图 (View) 或 视窗 (Windows) 时 ， 该 类 能 够 以 定义 好 的 行为 来 响应 触摸 。 


UlResponder 类 中 预先 定义 了 一 些 回调 方法 ,分别 用 来 处 理 “ 用 户 开 始 触 摸 屏 幕 ”、“ 在 屏幕 上 移动 手指 ”以 及 “从 屏幕 上 拿 开 手指 ”等 情况 。 相 关 的 方法 一 共 
有 四 个 ， 它 们 对 应 于 上 一 节 所 讲 的 阶段 : 


- touchesBegan: withEvent: 一 一 当 触 摸 事 件 处 于 “起 步 阶 段 ” (starting phase) ， 也 就 是 用 户 刚 开始 触 碰 屏 幕 时 ， 系 统 会 调用 这 个 方法 。 
- touchesMoved: withEvent: 一 一 当 用 户 触 摸 屏 幕 并 持续 在 屏幕 上 移动 手指 时 ， 系 统 会 调用 这 个 方法 。 
- touchesEnded: withEvent: 一 一 当 用 户 把 触摸 屏幕 的 一 根 手指 或 所 有 手指 都 从 屏幕 上 拿 开 时 ， 触 摸 过 程 就 结束 了， 而 系统 此 时 会 调用 这 个 方法 。 如 果 在 用 户 


移动 手指 的 过 程 中 程序 做 了 一 些 处 理 ， 那 么 此 时 应 该 执行 相关 的 清理 工作 。 


- touchesCancelled: WithEvent: Je ZA AE AE OY fk eS SB) AA, BAe Cocoa Touch 必 须 对 此 做 出 响应 ， 那 么 系统 就 会 调用 这 个 方法 。 


上 面 列 出 的 每 一 个 方法 都 是 UlResponder 方 法 ， 它 们 通常 会 由 UlIView 或 UIViewController 子 类 来 实现 。 所 有 的 视图 都 会 继承 这 几 个 方法 ， 而 继承 下 来 的 这 些 方法 
并 没有 实际 的 功效 。 如 果 想 使 自己 的 应 用 程序 支持 触摸 ， 就 应 该 履 写 这 些 方法 ， 并 在 其 中 编写 代码 ， 以 实现 应 用 程序 所 需 的 响应 功能 。 请 注 
意 ，UITouchPhasestationary 并 不 会 触发 回调 。 


你 目 己 的 类 可 以 把 四 个 方法 全 都 实现 了 ， 也 可 以 只 实现 其 中 的 某 些 方法 。 在 制作 真实 的 应 用 程序 时 ， 开 发 者 一 般 都 会 实现 touchesCancelled: WithEvent: , LA 
便 处 理 用 户 将 手指 拖 动 到 屏幕 边界 外 面 或 者 有 电话 打 进 来 的 情况 ， 在 这 两 种 情况 下 ， 当 前 的 触摸 序列 (touch sequence) 会 取消 。 一 般 来 说 ， 当 触摸 事件 取消 时 ,我 
们 可 以 在 回调 方法 里 面 调用 touchesEnded: withEvent: 方法 。 这 样 做 可 以 使 代码 “ 走 ” 完 整个 触摸 序列 ， 即 便 用 户 还 没有 把 手指 从 屏幕 上 拿 起 ， 程 序 也 依然 可 以 完 
成 触摸 序列 。 在 处 理 触摸 上 时， 苹果 公司 建议 开发 者 最 好 把 四 个 方法 全 都 覆 写 。 


Qi: 视图 有 个 模式 叫 作 exclusive touch， 此 模式 会 阻止 系统 把 触摸 投递 给 同一 个 视窗 里 的 其 他 视图 。 启 用 此 模式 之 后 ， 也 就 是 把 exclusiveTouch 属 性 设 为 YES 之 
后 ， 这 个 视窗 里 的 其 他 视图 就 收 不 到 触摸 事件 了 ， 而 是 由 主 视图 来 专门 负责 处 理 全 部 的 触摸 事件 。 


1.1.3 ”对 视图 的 触摸 


当 屏 幕 上 有 很 多 视图 的 时 候 ，iOs 会 目 动 判断 出 用 户 触 措 的 是 哪个 视图 ， 然 后 会 把 触摸 事件 传 给 适当 的 视图 去 处 理 。 这 样 一 来 ， 开 友 者 融 可 以 编写 具体 的 直接 操纵 
界面 ， 使 用 户 可 以 触摸 、 拖 忠 并 与 屏幕 上 的 物件 交互 。 


菏 个 视图 上 面 友 生 了 触摸 操作 并 不 意味 着 非得 由 这 个 视图 来 响应 触摸 。 每 个 视图 都 可 以 经 由 触摸 判定 机 制 (hit test) 来 选择 是 处 理 这 次 触摸 ， 还 是 把 它 留 给 下 面 
的 视图 去 处 理 。 在 后 面 的 解决 方案 中 ， 你 会 看 到 可 以 巧妙 地 运用 一 些 响应 策略 来 决定 视图 应 该 何 时 响应 触摸 ， 尤 其 当 我 们 使 用 了 半 透 明 的 特殊 图 形 时 ， 更 可 以 灵活 运 
FB TR. 


首 个 通过 点 击 测试 的 视图 可 以 决定 目 己 是 否 处 理 这 个 触摸 操作 。 如 果 此 视图 决定 把 这 个 触摸 操作 传递 出 去 ， 那 么 它 束 会 到 达 该 视图 的 上 级 视图 (superview) , 3f 
且 可 以 沿 着 响应 者 链 逐 级 向 上 传递 ， 直 至 有 视图 处 理 它 ， 或 是 到 达 拥 有 这 些 视图 的 视窗 为 止 。 若 视窗 也 不 处 理 此 操作 ， 那 么 触摸 事件 就 会 移动 到 UIApplication 实 例 ， 
ELBA, BAF. 


114 Braj 
iOS 支 持 单 点 触摸 (Single-Touch) 和 多 点 触摸 (Multi-Touch) 界面 。 单 点 触摸 GUI 每 次 只 能 处 理 一 个 触摸 操作 。 在 这 种 情况 下 ， 开 发 者 无 须 判断 当前 正在 追踪 
的 是 哪 一 个 触摸 事件 。 接 收 到 的 触摸 事件 也 就 是 待 处 理 的 触摸 事件 。 开 发 者 只 需要 查看 其 数据 、 响 应 此 事件 ， 并 等 待 下 一 个 事件 即 可 。 


在 处 理 多 点 触摸 ， 也 就 是 同时 响应 屏幕 上 的 多 个 触摸 上 时， 开发 者 收 到 的 是 一 组 触摸 。 你 需要 决定 其 顺序 并 响应 这 一 组 触摸 。 不 过 ， 你 也 可 以 自己 分 别 追踪 每 个 触 
摸 事 件 ， 观 察 它 们 各 自 是 如 何 随 着 时 | 间 的 推移 而 改变 的 ， 这 样 的 话 ， 你 束 可 以 实现 出 一 套 更 为 丰富 的 用 户 交 互 功能 了 。 本 草 稍 后 的 解决 方案 将 会 演示 单 点 触摸 和 多 点 
fs, 


1.1.5. 手势 识别 器 


手势 识别 器 是 苹果 公司 提供 的 一 种 强大 的 识别 方式 ， 用 来 检测 界面 中 的 特定 手势 。 手 势 识 别 器 简化 了 触摸 程序 的 设计 。 这 些 识别 器 本 身 束 封 浴 了 与 触摸 和 有关 的 方 
法 ， 所 以 开 友 者 无 须 目 己 来 实现 ， 它 们 提供 了 一 套 目 标 -动作 (target-action) 反馈 机 制 ， 这 套 机 制 能 把 实现 细节 隐藏 起 来 。 这 些 识别 器 同时 也 形成 了 一 套 标 准 ， 可 以 
把 某 些 移 动 形式 划分 到 不 同 的 类 别 里 面 ,例如 拖 忠 (drag) . ia) (swipe) =. 


使 用 了 手势 识别 器 类 之 后 ， 当 用 户 做 出 点 击 (tap) 、 双 指 聚 扰 (pinch) 、 旋 转 (rotate) 、 滑 动 (swipe) 、 拖 动 (pan) 或 长 按 (long press) 手势 和 时， 系统 
束 会 自动 触 友 相关 的 回调 方法 。 有 了 这 种 检测 能 力 ， 开 友基 于 触摸 的 界面 就 变 得 更 加 简单 了 。 为 了 提高 程序 的 可 靠 程 度 ， 你 可 以 自己 编写 相关 的 代码 ， 但 是 大 部 分 开 
发 者 都 沈 得 系统 上 自 市 的 识别 器 已 经 足够 健壮 ， 并 可 以 满足 很 多 应 用 程序 的 需求 。 本 章 将 会 给 出 几 个 基于 识别 器 的 解决 方案 。 由 于 各 种 识别 器 的 基本 工作 原理 都 一 样 ， 
所 以 你 可 以 轻易 地 扩展 这 些 解决 方案 ， 以 满足 自己 的 手势 识别 需求 。 


下 面 列 出 新 版 /OS SDK 内 置 的 几 种 手势 : 


C 氮 击 一 一 用 户 拿 一 根 或 多 根 手 指 触 碰 屏 幕 ， 这 就 是 点 击 。 用 户 可 以 拿 一 根 手 指 做 出 点 击 手势 ， 也 可 以 用 多 根 手 指 做 出 该 手势 。 开 发 者 通过 指定 gestufeRecognizets 
属性 来 设 定 自己 想 要 检测 的 点 击 次 数 。 你 可 以 创建 一 种 点 击 识别 器 ， 令 其 检测 用 一 根 手 指 所 做 的 点 击 ， 也 可 以 创建 更 为 复杂 的 识别 器 ， 比 方 说 ， 可 以 创建 一 种 识别 
器 ， 用 来 判断 用 户 是 否 以 两 根 手指 做 了 三 次 点 击 (two-fingered triple-tap) o 


` 滑动 一 一 在 水 平 或 重 直 方向 (也 就 是 上 、 下 、 左 、 右 ) 上 所 做 出 的 短 距离 单 点 触摸 或 多 点 触摸 手势 ， 就 叫 作 滑动 或 扫 屏 。 这 种 手势 不 能 太 偏离 主 方向 (primary 
direction) 。 开 发 者 可 以 在 识别 器 上 面 设 定 想 要 侦 测 的 方向 ， 而 识别 器 则 会 把 侦 测 到 的 方向 作为 属性 返回 给 开发 者 。 


. 双 指 聚拢 一 一 用 户 拿 两 根 手指 向 内 聚拢 ， 这 就 是 双 指 聚拢 (或 缩小 、 挤 压 ) 手势 ;两 根 手 指向 外 移动 ， 各 自 远离 ， 这 就 是 双 指 张 开 ( 或 扩大 、 拉 伸 ) 手势 。 识 
别 器 会 根据 挤 压 或 拉 伸 的 程度 把 缩放 因子 返回 给 开发 者 。 


- 旋转 一 一 两 根 手指 同时 依 顺 时 针 或 着 时 针 移 动 ， 这 就 是 旋转 手势 ， 识 别 器 会 把 旋转 角度 和 旋转 速度 返回 给 开发 者 。 
- 拖 动 一 一 拿手 指 在 屏幕 上 做 出 拖 慢 动作 ， 这 就 是 拖 动 (或 拖 移 ) 手势 。 识 别 器 会 侦 测 出 拖 慢 操作 所 产生 的 坐标 变化 。 


S 长 按 一 一 用 户 触 摸 屏幕 ， 并 在 某 段 时 间 内 按 着 手指 不 放 ， 这 就 是 长 按 手势 。 开 发 者 可 以 指定 用 户 必 须 按 下 多 少 根 手指 才能 令 识 别 器 侦 测 到 该 手势 。 


1.2 RDR: AORN ERR A 


在 开始 讲 比 较 流行 (也 比较 常用 ) 的 手势 识别 器 之 前 ,我 们 先 花 点 时 间 看 看 如 何 用 传统 的 方式 响应 用 户 触 摸 。 在 明日 了 UIResponder 类 里 面 简单 的 触摸 事件 处 理 
机 制 如 何 运作 之 后 ， 你 融 能 深入 理解 触摸 界面 了 。 


制作 直接 操纵 界面 时 ， 开 发 者 的 设计 重点 是 UlView ， 而 不 是 UIViewController。 研 发 直接 操纵 界面 时 的 核心 问题 就 是 视图 ， 或 者 说 得 更 准确 一 些 ， 是 
UIResponder。 我 们 自己 编写 从 UIResponder 类 继承 下 来 的 相关 方法 ， 以 创建 基于 触摸 的 界面 。 


解决 方案 1-1 中 的 代码 直接 实现 了 触摸 功能 。 这 段 范例 程序 创建 了 UllmageView 类 的 子 类 DragView， 并 为 该 类 添加 了 响应 触摸 的 能 力 。 由 于 这 是 个 ImageView,， 
所 以 要 记得 开启 用 户 交互 功能 (也 就 是 说 ， 应 该 把 setUserlnteractionEnabled 设 为 YES) 。 此 属性 既 会 影响 视图 本 身 ， 也 会 影响 它 的 所 有 子 视 图 。 大 部 分 的 视图 在 默 
认 情 况 下 都 已 经 启用 了 用 户 交 互 功 能 ,但 UllmageView 是 个 例外 ， 许 多 新 手 都 在 这 个 问题 上 卡 住 了 。 显 然 ， 苹果 公司 觉得 大 部 分 人 都 不 会 在 UllmageView 上 面 使 用 触 
措 功 能 。 

这 个 解决 方案 会 更 新 DragView 的 中 心 坐 标 ， 使 之 与 屏幕 上 的 触摸 移动 情况 相符 。 用 户 首次 触 碰 屏幕 上 的 某 个 DragView 时 ， 该 DragView 对 象 会 把 触摸 点 与 
DragView 的 原点 之 间 的 偏 移 量 保存 到 startLocation 对 象 里 面 。 用 户 拖 暇 这 个 DragView 的 时 候 ， 它 会 随 着 用 户 的 手指 一 起 移动 ， 也 就 是 说 ， 它 目前 的 原点 与 用 户 目前 


的 触 措 点 乙 间 的 仿 移 量 会 与 startLocation 里 面 所 保存 的 那个 量 相同 ， 这 样 的 话 ， 移 动 效果 融 会 显得 比较 平 消 。 我 们 通过 更 新 DragView 对 和 象 的 中 心 点 (center) 来 移动 
DragView。 解 决 方案 1-1 中 的 代码 会 算出 x 轴 和 y 轴 方向 上 的 侦 移 量 ， 并 在 用 户 每 次 移动 手指 的 时 候 据 此 调整 DragView 的 中 心 点 。 


解决 方案 1-1 ”创建 可 以 拖 灸 的 视图 


@implementation DragView 


| 


CGPoint startLocation; 


- (instancetype)initWithImage: (UIImage *)anImage 


self - [super initWithImage:anImage]; 
if (self) 


| 
| 


return self; 


self.userInteractionEnabled = YES; 


- (void)touchesBegan: (NSSet*)touches withEvent: (UIEvent*) event 


// Calculate and store offset, pop view into front if needed 
startLocation - [[touches anyObject] locationInView:self]; 
[self.superview bringSubviewToFront:self]; 


- (void)touchesMoved: (NSSet*)touches withEvent: (UIEvent*)event 


// Calculate offset 


CGPoint pt = [[touches anyObject] locationInView:self]; 
float dx - pt.x - startLocation.x; 
float dy - pt.y - startLocation.y; 
CGPoint newcenter - CGPointMake( 
self.center.x + dx, 
self.center.y + dy); 


// Set new location 
self.center - newcenter; 


—— 


| 


end 


E 


用 户 所 触摸 的 DragView 会 显示 在 屏幕 最 前 方 ， 这 是 因为 我 们 在 touchesBegan: withEvent: 里 调用 了 一 个 方法 ， 这 个 方法 会 告诉 DragView 的 上 级 视图 应 该 把 当 
前 DragView 币 到 屏幕 最 前 方 。 这 样 的 话 ， 当 前 处 于 活动 状态 的 元 件 束 忌 是 会 出 现在 界面 的 最 上 层 。 


这 个 解决 方案 并 没有 实现 与 触摸 结束 (touches-ended) 或 触摸 取消 (touches-cancelled) 有 关 的 方法 !']， 它 只 关注 用 户 在 屏幕 上 移动 手指 的 操作 。 当 用 户 不 再 
和 屏幕 交互 时 ，DragView 类 不 需要 做 后 续 的 处 理 。 


获取 解决 方案 代码 


H https: //github.com/etica/iOS-7-Cookbook A Jt , 3-4T7F "COlGestures 文件 夹 ， 即 可 找到 与 本 章 中 的 解决 方案 相对 应 的 完整 范例 项 目 。 


[1] 有 具体 指 的 就 是 touchesEnded:withEvent: 方 法 与 touchesCancelled:withEvent: 方 法 ， 下 同 。 译 者 注 


1.3 解决 方案 : 添加 拖 动 手势 识别 器 


用 手势 识别 器 也 可 以 实现 与 解决 方案 1-1 相 同 的 交互 功能 ， 而 且 还 不 用 直接 编写 触摸 处 理 程序 (1。 拖 动手 势 识别 器 可 以 侦 测 拖 岛 手势 。 只 要 iOS 系 统 检测 到 拖 动 手 
势 ， 它 就 会 触发 你 所 指定 的 回调 方法 。 


解决 方案 1-2 的 代码 与 解决 方案 1-1 的 相似 ， 在 首次 初始 化 时 ， 这 段 代码 会 向 视图 中 添加 识别 器 。 当 iOS 友 现 用 户 在 DragView 实 例 上 面 执行 抱 忠 时 ， 就 会 触 友 
handlePan: 回调 方法 ， 而 该 方法 会 更 新 DragView 的 中 心 点 ， 使 之 与 用 户 所 拖 遇 的 距离 相符 。 


这 段 代 码 计算 距离 的 方式 看 上 去 似乎 有 些 奇怪 。 它 把 视图 原来 的 位 置 保存 在 名 为 previousLocation 的 实例 变量 中 ， 然 后 在 系统 每 次 检测 到 拖 动 手势 并 触发 回调 方 
法 时 ,计算 目 前 位 置 与 previousLocation 之 间 的 偏 移 。 我 们 本 来 可 以 执行 仿 射 变换 (affine transform) 或 运用 setTranslation: inView: 方法 ， 但 本 例 却 采用 了 一 种 
不 常见 的 办 法 ， 就 是 移动 视图 的 中 心 点 。 解 决 方案 1-2 根 据 x 轴 和 y 轴 上 面 的 偏 移 量 创建 了 CGPoint， 并 依照 这 个 偏 移 量 来 设 定 视 图 的 中 心 点 ， 以 此 来 改变 视图 的 实际 位 


Ei. 


仿 射 变换 与 简单 的 偏 移 量 不 同 ， 它 可 以 同时 达成 旋转 、 缩 放 及 平移 操作 。 为 了 支持 变换 ， 手 势 识别 器 以 绝对 量 的 方式 来 描述 坐标 改变 ， 而 不 是 给 出 两 次 改变 之 间 
的 相对 差 值 。 这 样 就 不 需要 把 多 个 偏 移 量 累加 起 来 了 ， 因 为 UIPanGestureRecognizer 只 返回 一 个 变化 量 ， 这 个 变化 量 以 某 个 视图 的 坐标 系 来 描述 位 置 的 变化 ， 一 般 来 
说 ， 参 照 的 就 是 当前 视图 的 上 级 视图 的 坐标 系 。 有 了 这 个 平移 变化 量 ， 我 们 就 可 以 执行 一 些 简单 的 仿 射 变 损 计算 了 ， 而 且 还 可 以 通过 数学 运算 的 方式 与 其 他 变换 结合 
起 来 ， 达 到 一 次 性 执行 多 种 变换 操作 的 效果 。 


如 果 不 保存 状态 ， 而 是 直接 执行 变换 ， 那 么 handlePan: 方法 的 代码 就 会 变 成 下 面 这 个 样子 : 


- (void)handlePan: (UIPanGestureRecognizer *)uigr 


| 


if (uigr.state == UIGestureRecognizerStateEnded) 
CGPoint newCenter - CGPointMake( 
self.center.x « self.transform.tx, 
self.center.y « self.transform.ty); 
self.center - newCenter; 


CGAffineTransform theTransform = self.transform; 
theTransform.tx = 0.0f; 

theTransform.ty = 0.0f; 

self.transform = theTransform; 


return; 


CGPoint translation = [uigr translationInView:self.superview] ; 
CGAffineTransform theTransform = self.transform; 
theTransform.tx = translation.x; 

theTransform.ty = translation.y; 

self.transform = theTransform; 


请 注意 ， 手 势 识别 器 会 在 交互 操作 结束 的 时 候 更 新 视图 的 位 置 ， 并 重 设 transform 属 性 的 tx 与 ty。 经 过 上 述 改编 之 后 ， 我 们 就 无 须 在 程序 里 记录 上 一 次 的 位 置 了 ， 
于 是 也 就 用 不 着 touchesBegan: withEvent: 方法 了 。 若 是 不 按照 上 述 代码 来 编写 ， 那 么 解决 方案 1-2 必 须 保存 前 一 次 的 状态 。 


解决 方案 1-2 ”用 拖 动 手势 识别 器 实现 可 供 拖 蝶 的 视图 
@implementation DragView 


{ 


CGPoint previousLocation; 


- (instancetype)initWithImage: (UIImage *)anImage 


self - [super initWithImage:anImage]; 
if (self) 
{ 
self.userInteractionEnabled = YES; 
UIPanGestureRecognizer *panRecognizer = 
[[UIPanGestureRecognizer alloc] 
initWithTarget:self action:@selector (handlePan:]]; 
self.gestureRecognizers = @[panRecognizer] ; 


} 


return self; 


- (void)touchesBegan: (NSSet *)touches withEvent: (UIEvent *)event 
// Promote the touched view 
[self.superview bringSubviewToFront:self]; 


// Remember original location 
previousLocation = self.center; 


- (void)handlePan: (UIPanGestureRecognizer *)uigr 
CGPoint translation - [uigr translationInView:self.superview]; 
self.center = CGPointMake (previousLocation.x + translation.x, 
previousLocation.y + translation.y); 


} 


gend 


[1] 作者 把 touchesMoved:withEvent: 等 四 个 用 来 处 理 触 摸 事 件 的 方法 称 为 触摸 处 理 程序 (touch handler) 或 触摸 方法 ， 下 同 。 译 者 注 


1.4 解决 方案 : 同时 使 用 多 个 手势 识别 器 


解决 方案 1-3 是 基于 解决 方案 1-2 的 思路 而 构建 的 ， 但 是 两 者 之 间 有 一 些 区 别 。 首 先 ， 它 创建 了 多 个 平行 运作 的 识别 器 。 该 解决 万 案 的 代码 分 别 使 用 了 旋转 、 双 指 
聚拢 及 拖 动 这 三 种 识别 器 ， 并 把 它们 全 都 添加 到 了 DragView 的 gestureRecognizers 属 性 中 ， 然 后 它 把 DragView 设 为 每 个 识别 器 的 委托 册 。 这 样 的 话 ，DragView 就 
可 以 实现 名 为 gestureRecognizer: shouldRecognizeSimultaneouslyWithGestureRecognizer: 的 委托 方法 ， 从 而 令 多 个 识别 器 能 够 同时 运作 。 我 们 必须 实现 好 这 
个 方法 ， 并 将 其 返回 值 设 为 YES9， 否 则 在 同一 时 刻 丈 只 会 有 一 个 识别 器 起 作用 。 平 行使 用 多 个 识别 器 可 以 实现 出 一 些 功 能 ， 例 如 : 当 用 户 做 出 双 指 聚拢 手 势 时 ， 我 们 可 
以 同时 用 缩放 及 旋转 效果 来 响应 该 手势 。 


Qi UITouch 对 象 保 存 了 含有 手势 识别 器 的 数组 。 这 个 数组 里 的 每 个 元 素 都 是 手势 识别 器 ， 而 每 个 识别 器 都 用 来 接收 相关 的 触摸 对 象 。 如 果 创 建 某 个 视图 时 
没有 指定 手势 识别 器 ， 那 么 在 系统 传 给 响应 者 方法 的 触摸 对 象 里 面 ，gestuteRecognizets 数 组 就 是 空 的 。 


解决 方案 1-3 扩 充 了 视图 的 状态 ， 给 对 象 添加 了 与 缩放 和 旋转 功能 有 关 的 实例 变量 。 这 些 变量 可 以 记录 前 一 次 的 变换 值 ， 而 程序 代码 则 会 根据 它们 来 合成 仿 射 变 
换 。 仿 射 变换 的 效果 是 在 解决 方案 1-3 的 updateTransformWithOffset: 方法 里 面 合 成 出 来 的 ， 该 方法 把 平移 、 旋 转 及 缩放 这 三 种 操作 合并 成 一 个 效果 。 与 前 一 个 解 
决 方案 不 同 ， 这 份 解决 方案 统一 经 由 self.transform 来 实现 对 视图 的 修改 ， 而 这 也 是 使 用 手势 识别 器 时 的 常见 做 法 。 


解决 方案 1-3 ”同时 识别 多 种 手势 


@interface DragView : UIImageView «UIGestureRecognizerDelegate» 
@end 


@implementation DragView 

{ 
CGFloat tx; // x translation 
CGFloat ty; // y translation 
CGFloat scale; // zoom scale 
CGFloat theta; // rotation angle 


- (void)touchesBegan: (NSSet *)touches withEvent: (UIEvent *)event 
// Promote the touched view 
[self.superview bringSubviewToFront:self]; 


// initialize translation offsets 
tx = self transform tx) 

ty = self.transform.ty; 

scale = self.scalex; 

theta = self.rotation; 


| 


- (void)touchesEnded: (NSSet *)touches withEvent: (UIEvent *)event 
| 
UITouch *touch = [touches anyObject]; 
if likouch.tapCount se 3) 
{ 
// Reset geometry upon triple-tap 
self.transform = CGAffineTransformIdentity; 
tx = 0.0£; ty = 0.0f; scale = 1.0f; theta = 0.0f; 


- (void)touchesCancelled: (NSSet *)touches withEvent: (UIEvent *)event 


[self touchesEnded:touches withEvent:event]; 


(void)updateTransformWithOffset: (CGPoint)translation 


// Cxeate a blended transform representing translation, 
// rotation, and scaling 
self.transform - CGAffineTransformMakeTranslation( 
translation.x + tx, translation.y + ty); 
self.transform - CGAffineTransformRotate(self.transform, theta); 


// Guard against scaling too low, by limiting the scale factor 
if (self.scale > 0.5f) 


{ 


self.transform = CGAffineTransformScale(self.transform, scale, scale); 


} 


else 


{ 


self.transform = CGAffineTransformScale(self.transform, 0.5f, 0.5f); 


(void) handlePan: (UIPanGestureRecognizer *)uigr 
CGPoint translation = [uigr translationInView:self.superview] ; 
[self updateTransformWithOffset:translation]; 
(void)handleRotation: (UIRotationGestureRecognizer *)uigr 


theta - uigr.rotation; 
[self updateTransformWithOffset:CGPointZero]; 


(void) handlePinch: (UIPinchGestureRecognizer *)uigr 


scale = uigr.scale; 
[self updateTransformWithOffset:CGPointZero]; 


(BOOL) gestureRecognizer: (UIGestureRecognizer *)gestureRecognizer 
shouldRecognizeSimultaneouslyWithGestureRecognizer: 
(UIGestureRecognizer *)otherGestureRecognizer 


return YES; 


(instancetype)initWithImage: (UIImage *)image 


// Initialize and set as touchable 
self - [super initWithImage:image]; 


if (self) 


| 


self.userInteractionEnabled = YES; 


// Reset geometry to identities 
self.transform = CGAffineTransformIdentity; 
tx = 0.0f; ty = 0.0£; scale = 1.0f; theta = 0.0f; 


// Add gesture recognizer suite 
UIRotationGestureRecognizer *rot = 
[[UIRotationGestureRecognizer alloc] 
initWithTarget:self 
action:@selector (handleRotation:)]; 
UIPinchGestureRecognizer *pinch = 
[[UIPinchGestureRecognizer alloc] 
initWithTarget:self 
action:@selector (handlePinch: ) ] ; 
UIPanGestureRecognizer *pan = 
[[UIPanGestureRecognizer alloc] 
initWithTarget:self 
action:@selector (handlePan: ) ] ; 
self.gestureRecognizers = G[rot, pinch, pan]; 
for (UIGestureRecognizer *recognizer 
in self.gestureRecognizers) 
recognizer.delegate - self; 


} 


return self; 


| 


@end 


最 后 请 大 家 注意 ， 这 份 解决 方案 同时 实现 了 两 套 手 势 识 别 机 制 。 一 方面 ， 我 们 给 视图 的 gestureRecognizers 数 组 里 添加 了 手势 识别 器 对 象 ， 而 另 一 方面 ， 我 们 像 
解决 方案 1-1 那 样 ， 通 过 基本 的 触摸 方法 来 捕捉 “三 连 击 ” (triple-tap) 上 操作 。 在 本 例 中 ， 当 用 户 执行 三 连 击 操作 时 ， 会 把 视图 的 transform 重 置 为 恒 等 变换 中 。 这 
样 的 话 ， 原 来 对 该 视图 所 做 的 操作 就 将 全 部 还 原 ， 这 个 视图 的 位 置 、 方 向 及 尺寸 都 会 回 到 原来 的 样子 。 通 过 这 段 代 码 ， 大 家 可 以 看 到 touchesBegan.、 
touchesMoved、touchesEnded 及 touchesCancelled 这 四 个 方法 与 手势 识别 器 的 回调 方法 是 并 行 不 迟 (work seamlessly) 的 ， 笔 者 之 所 以 要 在 解决 方案 中 同时 实现 
两 套 手 势 识别 机 制 ， 就 是 为 了 使 大 家 体会 到 这 一 点 。 同 样 的 功能 其 实 也 可 以 通过 添加 UITapGestureRecognizer 来 实现 。 


大 家 通过 这 个 解决 方案 可 以 感 完 到 ， 用 手势 识别 器 来 处 理 触 摸 操 作 是 非常 简明 的 。 
解决 手势 冲突 


如 果 需 要 同时 辨认 多 种 手势 ， 那 么 可 能 会 产生 手势 冲突 (gesture conflict) 。 比 方 说 ， 需 要 同时 识别 单 击 (single-tap) 和 双击 (double-tap) 的 时 候 ， 就 会 出 
现 问题 。 如 果 用 户 想 执行 的 是 双击 操作 ， 那 么 负责 识别 单 击 操作 的 识别 器 是 应 该 在 用 户 第 一 次 点 击 的 时 候 就 触发 单 击 操作 ， 还 是 应 该 等 到 用 户 彻底 不 打算 点 击 第 二 下 
的 时 候 再 去 响应 呢 ? iOS SDK 提 供 了 一 些 手段 ， 使 开发 者 可 以 通过 代码 来 解决 这 些 冲 突 。 


我 们 在 编写 类 的 代码 时 ， 可 以 指明 必须 等 某 个 手势 无 法 触 友 时 ， 才 去 触 友 另 一 个 手势 。 这 种 规则 可 以 通过 调用 requireGestureRecognizerToFail: 方法 来 确立 。 
UlGestureRecognizer 里 的 这 个 方法 接收 一 个 参数 ， 也 就 是 另外 一 个 手势 识别 器 。 调 用 该 方法 之 后 ， 两 个 手势 识别 器 之 间 就 创建 了 依赖 关系 。 系 统 必 须 先 确定 另外 一 
个 手势 无 法 触发 ， 然 后 才能 触发 当前 这 个 手势 。 假 如 系统 可 以 辨识 出 另外 一 个 手势 ， 那 么 就 不 触发 这 个 手势 了 。 


iOS 7 引入 了 一 些 新 的 AP1， 经 由 UlGestureRecognizer 的 委托 及 子 类 ， 我 们 可 以 在 运行 期 (runtime) 实现 更 为 灵活 的 手势 判定 规则 扑 。 在 UlGestureRecognizer 
的 委托 中 ， 我 们 可 以 实现 gestureRecognizer: shouldRequireFailureOfGestureRecognizer: 方法 及 gestureRecognizer: 
shouldBeRequiredToFailByGestureRecognizer: 方法 ， 而 在 UlGestureRecognizer 的 子 类 中 ， 则 可 以 履 写 shouldReduireFailureOfGestureRecognizer: 方法 及 
shouldBeRequiredToFailByGestureRecognizer: 方法 。 


对 于 上 面 所 说 的 四 个 方法 ， 其 返回 值 均 为 布尔 类 型 。 如 果 返 回 的 是 YES， 就 意味 着 必须 等 基 个 手势 彻底 无 法 触发 时 才能 触发 另 一 个 手势 。 每 当 识 别 器 想 要 辨识 某 个 
手势 时 ， 系 统 就 会 调用 UlGestureRecognizer 的 相关 委托 方法 ， 这 样 一 来 ， 我 们 就 可 以 在 处 于 不 同 视 图 体系 的 识别 器 对 象 之 间 建 立 依赖 关系 了 ， 此 外 ， 如 果 想 定义 针 
对 某 个 UlGestureRecognizer 子 类 的 手势 辨识 规则 ， 那 么 可 以 在 其 中 履 写 并 实现 相关 的 方法 。 


在 开 必 真实 的 应 用 程序 时 ， 如 果 设 吓 了 手势 间 的 依赖 天 系 ， 束 意味 着 识别 器 的 反应 时 | 间 会 有 所 延迟 ， 因 为 它 得 等 男 一 个 识别 器 彻底 失败 为 止 。 也 惑 是 说 ， 它 得 等 
到 另 一 个 手势 彻底 无 法 触 友 ， 只 有 到 那 时 ， 该 识别 器 才能 完成 对 本 手势 的 辨识 。 如 果 我 们 要 同时 辨识 单 击 和 双击 ， 那 么 当 用 户 初 次 点 击 屏 幕 之 后 ， 应 用 程序 必须 多 等 
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一 种 。 


为 了 适应 这 种 规则 变化 ，GUI 的 响应 能 力 会 下 降 ， 它 对 单 击 操作 的 响应 会 稍 显 “迟钝 ”。 这 是 因为 程序 必须 等 待 一 段 时 间 ， 才 能 判断 出 是 否 会 友 生 双击 。 假 如 程序 
的 高 速 响应 能 力 对 用 户 体 验 有 着 非常 重要 的 影响 ， 那 么 就 不 要 同时 使 用 这 两 种 识别 器 了 ， 而 是 应 该 把 单 击 行为 解读 为 立刻 执行 某 操 作 。 在 这 种 情况 下 ， 不 应 该 同时 设 
计 单 击 及 双击 这 两 种 手势 。 


大 家 可 别 志 了 ， 开 友 者 可 以 随时 添加 、 移 除 或 禁用 手势 识别 器 。 比 方 说， 用户 在 执行 单 击 操作 之 后 ， 程 序 界面 会 进入 另 一 种 模式 ， 而 在 那 种 模式 下 ， 用 户 可 以 分 
别 通过 单 击 和 双击 来 做 不 同 的 事情 。 离 开 了 那 种 模式 之 后 ， 开 友 者 可 以 将 辨识 双击 手势 所 用 的 识别 器 移 除 或 禁用 ， 这 样 能 够 重新 提高 程序 对 单 击 操作 的 辨识 速度 。 在 
确 有 必要 时 ， 这 种 优化 技术 可 以 缓解 界面 的 延迟 现象 。 


1] “把 A 设 为 B 的 委托 ”或 “把 A 赋 给 B 的 委托 属性 ”这 种 句 式 ， 其 大 概 的 意思 是 : 也 需要 通过 某 个 实现 了 C 协 议 的 对 象 来 处 理发 生 在 B 身 上 的 一 些 事 件 ， 而 A 对 象 所 属 的 
类 实现 了 C 协 议 ， 于 是 ， 我 们 就 用 A 来 处 理发 生 在 B 上 面 的 事件 。 这 时 ，C 协 议 中 所 约定 的 一 些 方法 就 叫 作 “B 的 委托 方法 ”， 而 A 或 A 所 属 的 类 则 可 以 泛称 为 “B 的 委 
托 ”。 具 体 到 解决 方案 1-3 来 说 ， 这 种 句 式 对 应 于 代码 中 的 “recognizet.delegate = self”， 其 中 的 self 就 是 A，recognizer 就 是 B。 译 者 注 

[2] 短 时 间 内 连续 做 三 次 点 击 。 译 者 注 

[2] 也 就 是 没有 经 过 任何 平移 、 旋 转 及 缩放 的 变换 效果 ， 可 以 理解 为 “单位 矩阵 ”。 
[4] JR CAR A failure condition (失败 条 件 ) 。 译 者 注 


译 者 注 


1.5 解决 方案 : 限制 移动 


本 章 前 面 几 个 解决 方案 所 使 用 的 办 法 都 比较 简单 ， 但 是 有 个 问题 ， 就 是 用 户 完 全 有 可 能 把 某 个 视图 拖 动 到 屏幕 之 外 ， 导 致 其 难以 把 自己 看 不 到 的 视图 重新 拖 回 到 
屏幕 内 。 那 些 解决 方案 没有 对 移动 施加 限制 。 它 们 并 没有 判断 用 户 所 要 操作 的 对 象 是 不 是 处 在 大 视图 的 范围 内 ， 而 且 也 没有 判断 那个 对 象 是 不 是 可 供 触摸 。 解 决 方案 
1-4 对 视图 在 其 上 级 视图 内 的 移动 行为 做 出 了 限制 ， 从 而 解决 了 此 问题 。 具 体 的 限制 办 法 是 : 从 x 轴 和 y 轴 方向 上 分 别 检查 视图 的 移动 是 否 符 合 规 则 ， 以 此 来 限制 其 在 每 
个 方向 上 的 移动 行为 。 分 两 个 轴 来 检测 有 个 好 处 ， 就 是 即便 视图 对 象 在 某 个 轴 上 已 经 移动 到 了 边界 ， 它 也 依然 可 以 在 另 一 个 轴 上 面 继续 移动 。 比 方 说， 就 算 视 图 已 经 
页 到 了 上 级 视图 的 右边 界 ， 它 也 照样 可 以 在 素 直 方向 上 下 移动 。 


Qi iOS 7 引入 了 一 套 UIKit Dynamics API， 用 于 对 真实 的 物理 现象 进行 建 模 ， 其 中 包含 物理 模拟 及 响应 式 动画 等 功能 。 开 发 者 可 以 使 用 这 套 声 明 式 的 
Dynamics API 来 对 重力 、 碰 撞 、 力 、 附 着 、 弹 簧 、 伸 缩 等 大 量 现 象 进 行 建 模 ， 并 将 其 效果 运用 在 UIKit 物 件 上 面 。 但 是 本 条 解决 方案 采用 传统 的 做 法 ， 也 就 是 通过 手势 
识别 器 以 及 直接 框架 操作 (direct frame manipulation) 来 实现 UI 物 件 的 移动 并 对 其 施加 限制 ， 读 者 可 以 用 Dynamics 实 现 出 更 为 精致 的 版 本 。 


图 1-1 演 示 了 一 个 样本 界面 。 程 序 将 各 个 子 视图 (也 残 是 图 中 的 伦 ) 的 移动 学 围 限 制 在 界面 中 央 的 黑色 起 形 内 ， 使 用 户 无 法 将 其 拖 到 屏幕 范围 书 外。 解决 方案 1-4 
的 代码 写 得 比较 通用 ， 所 以 你 可 将 其 改编 ， 使 之 适用 于 任意 尺寸 的 外 围 边 界 (parent bound) 及 子 视图 。 


解决 方案 1-4 ”范围 受 限 的 移动 


| 


(void)handlePan: 


图 1-1 MBAR RAL AE T] 


(UIPanGestureRecognizer *)uigr 


CGPoint translation - [uigr translationInView:self.superview]; 
CGPoint newcenter = CGPointMake ( 


previousLocation.x + translation.x, 


previousLocation.y + translation.y); 


// Restrict movement within the parent bounds 


float halfx = 
newcenter.x - 
newcenter.x - 


newcenter. 


float halfy - 
newcenter.y - 


newcenter. y = 


newcenter. 


CGRectGetMidX (self.bounds) ; 
MAX(halfx, newcenter.x) ; 
MIN(self.superview.bounds.size.width - halfx, 


x) 


CGRectGetMidY (self.bounds); 
MAX(halfy, newcenter.y); 
MIN(self.superview.bounds.size.height - halfy, 


y): 


// Set new location 


self.center - 


newcenter; 


由 于 直接 操纵 界面 中 的 大 部 分 屏幕 视图 元 件 (onscreen view element) 都 不 是 和 矩形， 所 以 触摸 测试 实现 起 来 会 比较 困难 ， 因 为 视图 所 在 的 矩形 框 与 实际 应 该 接 
受 触 摸 的 学 围 并 不 完全 相同 。 图 1-2 演 示 了 这 个 问题 。 右 侧 的 屏幕 截图 展示 了 整套 界面 以 及 界面 中 可 供 触 碰 的 各 个 子 视图 ， 而 左 侧 的 截图 则 摘 绘 出 每 个 子 视图 周围 的 矩 
形 框 ' J。 其 中 灰色 的 部 分 虽然 处 在 矩形 框 范围 之 内 ， 但 却 在 圆圈 外 面 ， 因 此 ， 如 果 用 户 触 碰 了 这 个 区 域 ， 那 么 应 用 程序 不 应 该 判定 其 点 击 (hit) 了 相关 的 子 视图 。 

只 要 触 碰 点 位 于 视图 的 范围 内 ，iOS 就 会 侦 测 到 这 一 动作 。 这 个 范围 既 包 括 视图 的 主体 部 分 ， 也 包括 用 户 看 不 到 的 区 域 ， 也 就 是 图 1-2 左 侧 截 图 中 处 于 圆 形 之 外 但 


又 位 于 息 形 之 内 的 灰色 区 域 。 在 图 1-2 右 侧 截图 中 ， 每 个 UIView 本 体 周围 的 透明 部 分 (clear portion) 的 下 方 可 能 还 有 别 的 视图 ， 所 以 我 们 必须 添加 某 种 触摸 判定 机 
制 (hit test) ， 才 能 使 用 户 可 以 触 碰 到 那些 视图 。 


如 果 想 把 视图 所 对 应 的 矩形 框 显示 出 来 ， 那 么 可 以 用 下 面 代码 来 设 定 其 背景 色 : 
dragger.backgroundColor = [UIColor lightGrayColor]; 
这 样 束 可 以 在 不 影响 屏幕 实际 图 形 的 前 提 下 ， 给 它们 后 方 画 上 一 块 灰色 的 板子 ， 如 图 1-2 左 侧 截 图 所 示 。 在 本 例 中 ， 每 个 视图 的 主体 部 分 都 是 圆 形 图 样 ， 如 果 不 添 
加 上 面 的 代码 ， 那 么 其 背景 色 就 是 透明 的 。 由 此 可 见 ， 我 们 必须 添加 某 种 触摸 判定 机 制 ， 否 则 ， 如 果 用 户 点 击 了 透明 部 分 ， 系 统 就 会 认为 用 户 点 击 的 是 相关 的 视图 。 


手工 指定 背景 色 是 一 种 便捷 的 调试 手法 ， 它 使 开 友 者 能 够 看 到 每 个 视图 真正 应 该 接受 触摸 的 范围。 在 发 布 正式 产品 之 前 ， 别 筷 了 把 对 背景 色 的 赋值 语句 注释 挥 。 除 了 
笔者 所 说 的 这 种 调试 办 法 乙 外 ， 还 有 一 种 办 法 ， 融 是 设 定 视图 的 层 (layer) 所 具备 的 边框 宽度 及 样式 。 


图 1-2 ”在 左 图 中 ， 如 果 用 户 触 摸 了 圆圈 外 围 的 灰色 区 域 ， 那 么 应 用 程序 不 应 判定 其 点 击 了 相关 的 子 视 图 。 右 边 这 幅 图 中 ， 把 左 图 中 每 个 子 视 图 周围 的 灰色 部 分 用 全 透 
明 色 【〈 也 就 是 lpha 值 为 0 的 颜色 ) 来 描绘 ， 这 样 就 能 显露 出 实际 应 该 接受 触 碰 的 部 分 了 


解决 方案 1-5 给 视图 添加 了 简单 的 触摸 判定 机 制 ， 以 判断 触摸 点 是 否 在 圆圈 范围 内 。 我 们 是 通过 覆 写 UIView 的 pointinside: withEvent: 方法 来 实现 此 机 制 的 。 
该 方法 如 果 返 回 YES， 就 表明 触摸 点 位 于 视图 之 内 ， 如 果 返 回 NO， 则 表明 不 在 视图 之 内 。 本 例 所 实现 的 判定 机 制 采用 的 是 基本 的 几何 运算 ， 也 就 是 检查 触摸 点 是 不 是 
在 圆圈 的 半径 之 内 。 你 也 可 以 采用 与 自己 的 应 用 程序 相符 的 其 他 办 法 来 判断 用 户 是 否 触摸 了 屏幕 上 的 视图 。 在 下 一 节 的 解决 方案 1-6 中 ， 笔 者 会 对 判定 代码 进行 扩充 ， 
以 实现 更 加 精细 的 控制 。 


解决 方案 1-5 ”判断 某 个 点 是 否 位 于 圆 形 的 视图 中 


- (BOOL) pointInside: (CGPoint)point withEvent: (UIEvent *)event 


| 
CGPoint pt; 
float halfSide - kSideLength / 2.0f; 


// normalize with centered origin 
pt.x = (point.x - halfSide) / halfSide; 
pt.y = (point.y - halfSide) / halfSide; 


// x^2 + y^2 = radius^2 
float xsquared - pt.x * pt.x; 
float ysquared - pt.y * pt.y; 


// If the radius « 1, the point is within the clipped circle 
if ((xsquared + ysquared) < 1.0) return YES; 
return NO; 


请 注意 ， 对 于 配备 了 Retina 显 示 屏 的 设备 ， 其 触摸 检测 方式 与 老式 的 设备 相同 ， 在 做 数学 运算 时 ， 使 用 的 也 是 标 侍 的 点 坐标 系统 ， 而 不 是 实际 的 像素 。 设 备 上 多 
出 来 的 像素 并 不 影响 处 理 手 为 时 所 用 的 数学 算式 。 视 图 的 坐标 系统 依然 采用 亚 像 素 精度 (subpixel accuracy) 的 浮 点 数 。 设 备 绘制 屏幕 内 容 时 所 采用 的 具体 像素 数 既 
` 会 影响 UIView 的 范围 框 ， 也 不 会 影响 UITouch 中 的 坐标 。 它 只 是 一 种 能 在 坐标 系统 中 提高 绘制 精度 的 手段 。 


Qi 我 们 这 里 所 说 的 触摸 判定 机 制 Chit test) 是 指 一 种 判断 点 是 不 是 处 于 视图 之 中 的 机 制 ， 而 不 是 指名 字 看 上 去 与 之 相似 的 hitTest: withEvent: 方法 。 这 个 
方法 用 于 返回 视图 体系 中 包含 某 个 点 的 最 顶层 视图 (topmost view， 也 就 是 距离 用 户 及 屏幕 最 近 的 视图 ) 。 它 会 在 每 个 视图 上 面 调用 pointInside: withEvent: 。 如 果 


pointInside 方 法 返回 YES， 那 么 它 就 会 沿 着 视图 体系 继续 向 下 判断 。 


[1] 也 称 为 范围 框 、 边 界 框 、 绑 定 框 。 


译 者 注 


1.7 解决 方案 : 针对 位 图 的 触摸 测试 


解决 方案 1-5 所 用 的 触摸 判定 方式 非常 直观 ， 它 只 做 了 一 些 简单 的 几何 运算 ， 但 不 巧 的 是 ， 大 部 分 视图 都 不 是 解决 方案 1-5 所 演示 的 样子 。 比 方 说 ， 对 于 图 1-1 中 的 
伦 抄 ， 其 边界 融 是 不 规则 的 ， 而 且 其 透明 度 也 有 变化 。 如 果 图 形 比较 复杂 ， 我 们 融 必 须 针 对 位 图 来 做 测 坛 ， 才 能 判断 是 否 友 生 了 触 措 。 对 基于 图 像 的 视图 (image- 
based view) 来 说 ， 位 图 是 一 种 按 字 节 排列 的 信息 ， 它 摘 述 了 该 视图 的 内 容 ， 从 而 使 开 友 者 可 以 判断 出 用 户 到 底 是 触 措 了 图 中 不 透明 的 部 分 (solid portion) ， 还 是 
触 措 了 透明 的 部 分 ， 如 果 是 后 者 ， 融 应 该 转 而 判断 位 图 下 方 的 视图 是 人 否 受到 触摸 。 


解决 方案 1-6 从 UllmageView 里 面 提 取 了 一 幅 图 像 的 位 图 。 它 假定 受 测 的 视图 是 以 像素 来 描述 其 中 的 图 像 的 。 假 如 你 要 扭曲 视图 的 话 (一 般 可 以 通过 调整 框架 
(frame) 的 大 小 或 运用 坐标 变换 来 实现 担 曲 效果 ) ， 那 么 需要 修改 判定 触摸 所 用 的 算式 。 开 发 者 可 以 通过 CGPointApplyAffineTransform() 来 对 CGPoint 执 行 变换 ， 
以 处 理由 于 缩放 及 旋转 而 带 来 的 坐标 变更 。 为 了 简化 判断 过 程 ， 也 为 了 避免 繁杂 的 数学 运算 ， 我 们 把 视图 的 图 像 与 其 实际 像素 之 比 定 为 1 : 1。 你 可 以 把 待 测试 的 像素 
取出 来 ， 测 试 其 透明 程度 ， 并 据 此 判断 用 户 是 否 点 击 了 视图 中 不 透明 的 部 分 。 


解决 方案 1-6 根据 位 图 像素 的 不 透明 程度 来 测试 触 措 


// Return the offset for the alpha pixel at (x,y) for RGBA 
// 4-bytes-per-pixel bitmap data 
static NSUInteger alphaOffset(NSUInteger x, NSUInteger y, NSUInteger w) 


{return y * w* 4 « x * 4;] 


// Return the bitmap from a provided image 
NSData *getBitmapFromImage (UIImage *image) 


| 


if (!sourceImage) return nil; 


// Establish color space 
CGColorSpaceRef colorSpace - CGColorSpaceCreateDeviceRGB(); 
if (colorSpace -- NULL) 

NSLog(G"Error creating RGB color space"); 

return nil; 


// Establish context 
int width = sourceImage.size.width; 
int height - sourceImage.size.height; 
CGContextRef context - 
CGBitmapContextCreate (NULL, width, height, 8, 
width * 4, colorSpace, 
(CGBitmapInfo) kCGImageAlphaPremultipliedFirst); 
CGColorSpaceRelease(colorSpace); 
if (context == NULL) 
( 
NSLog(G"Error creating context"); 
return nil; 


// Draw source into context bytes 
CGRect rect = (CGRect){.size = sourceImage.size}; 
CGContextDrawImage (context, rect, sourceImage.CGImage); 


// Create NSData from bytes 
NSData *data - 
[NSData dataWithBytes:CGBitmapContextGetData (context) 
length: (width * height * 4)]; 
CGContextRelease (context); 


return data; 


// Store the bitmap data into an NSData instance variable 
- (instancetype)initWithImage: (UIImage *) anImage 
{ 
self = [super initWithImage:anImage] ; 
if (self) 
{ 
self.userInteractionEnabled = YES; 
data = getBitmapFromImage (anImage) ; 


} 


return self; 


// Does the point hit the view? 
- (BOOL)pointInside: (CGPoint)point withEvent: (UIEvent *) event 


{ 
if (!CGRectContainsPoint(self.bounds, point)) return NO; 
Byte *bytes - (Byte *)data.bytes; 
uint offset - alphaOffset(point.x, point.y, self.image.size.width); 
return (bytes[offset] » 85); 


本 例 所 使 用 的 分 界 值 是 85。 葡 是 说 ， 受 测 像 素 的 不 透明 程度 至 少 是 33% (也 融 是 大 约 85/255) ， 我 们 才能 认定 用 尸 点 击 了 这 个 视图 。 我 们 所 编写 的 pointinside: 
方法 会 将 不 透明 度 低 于 33% 的 像素 视 为 透明 。 这 个 值 是 笔者 随意 选取 的 。 你 可 以 根据 上 自己 GUI 的 实际 需求 来 调整 访 值 (当然 也 可 以 换 用 另外 的 判定 算法 ) 。 


Qs 除非 你 要 实现 完美 的 像素 级 触摸 检测 ， 否 则 可 以 先 把 位 图 缩小 ， 然 后 再 用 修改 过 的 草 式 去 判断 ， 这 样 占用 的 内 存 会 少 一 些 。 


18 ”解决 方案 : 根据 触摸 情况 在 屏幕 上 绘制 内 容 


开 友 者 可 以 在 UIView 的 范围 内 实现 直接 屏幕 绘制 (direct onscreen drawing) 。 它 的 drawRect: 方法 提供 了 一 种 低 阶 的 方式 ， 令 我 们 能 够 使 用 Quartz 2D API 
来 创建 及 显示 任意 元 件 ， 并 直接 向 屏幕 中 绘制 内 容 。 将 触 措 与 绘制 结合 起 来 ， 融 能 构建 出 既 直 观 而 又 容易 操控 的 界面 。 


解决 方案 1-7 把 手势 与 drawRect 相 结合 ， 实 现 出 了 基于 触摸 的 绘画 功能 。 用 户 触 措 屏幕 时 ，TouchTrackerView 类 会 随 着 用 户 的 手指 而 构建 贝 塞 尔 曲线 。 为 了 在 用 
户 触摸 屏幕 的 过 程 中 实现 绘画 功能 ， 我 们 令 程 序 的 touchesMoved: withEvent: 方法 调用 setNeedsDisplay， 而 setNeedsDisplay 又 会 触发 drawRect: ， 后 者 将 根据 
收集 到 的 贝 塞 尔 曲线 信息 在 视图 中 绘制 相关 图 形 。 图 1-3 中 的 界面 演示 了 用 此 方式 创建 出 的 一 条 路 径 。 


解决 方案 1-7 ”在 UIView 中 实现 基于 触 措 的 绘画 功能 


@implementation TouchTrackerView 


| 


UlBezierPath * path; 


- (instancetype)initWithFrame: (CGRect) frame 
self = [super initWithFrame:frame] ; 
if (self) 
| 


self.multipleTouchEnabled - NO; 


return self; 


- (void)touchesBegan: (NSSet *)touches withEvent: (UIEvent *)event 


// Initialize a new path for the user gesture 
path = [UIBezierPath bezierPath]; 
path.lineWidth - IS IPAD ? 8.0f : 4.0f; 


UITouch *touch = [touches anyObject]; 
[path moveToPoint: (touch locationInView:self]]; 


- (void) touchesMoved: (NSSet *)touches withEvent: (UIEvent *)event 


// Add new points to the path 

UITouch *touch = [touches anyObject] ; 

[self.path addLineToPoint: [touch locationInView:self]]; 
[self setNeedsDisplay] ; 


- (void) touchesEnded: (NSSet *)touches withEvent: (UIEvent *) event 


UITouch *touch = [touches anyObject] ; 
[path addLineToPoint: [touch locationInView:self]]; 
[self setNeedsDisplay] ; 


- (void) touchesCancelled: (NSSet *) touches 
withEvent: (UIEvent *)event 


[self touchesEnded:touches withEvent:event] ; 


- (void) drawRect: (CGRect) rect 


// Draw the path 
[path stroke] ; 


| 


Gend 
里 说 我 们 可 以 用 手势 识别 器 来 改写 本 例 ， 但 这 样 做 没有 实际 意义 。 本 程序 中 的 触摸 信息 并 没有 太 大 的 用 途 ， 我 们 只 不 过 是 用 其 来 创建 一 条 平滑 的 轨迹 。 基 本 的 响 
应 者 方法 (也 瓯 是 touchesBegan、touchesMoved 等 方法 ) 完全 可 以 应 付 路 径 的 创建 及 管理 等 事宜 。 


本 例 创建 出 来 的 是 连续 轨迹 。 该 程序 并 不 响应 静止 的 触摸 事件 。 假 如 读者 想 扩充 这 个 范例 程序 ， 使 其 具备 画 点 或 画 符 号 的 能 力 ， 需 要 自己 去 添加 相关 的 行为 代 
码 。 


图 1-3 ”一 套 简 单 的 iOS 绘 画工 具 ， 其 所 使 用 的 技术 只 不 过 就 是 沿 着 路 径 收 集 触 摸 信息 ， 并 调用 UIKit/Quatrtz 2D API 将 其 绘制 出 来 


1.9 解决 方案 : 令 给 制 效果 变 得 平 交 


用 户 所 使 用 的 设备 各 有 不 同 ， 其 设备 在 同一 时 间 所 能 处 理 的 运算 量 也 不 一 样 ， 这 就 导致 捕捉 到 的 触摸 事件 可 能 要 比 预期 的 粗略 一 些 。 与 生活 中 轮 鳃 握手 时 的 情况 
类 似 ， 和 触摸 事件 的 采样 率 通常 受 限 于 CPU 的 能 力 。 我 们 可 以 在 点 之 间 进 行 插值 (interpolating) ， 用 平滑 算法 (smoothing algorithm) 来 缓解 这 些 限制 。 通 过 图 1-4 
我 们 可 以 看 到 ， 用 采集 到 的 触 措 氮 直接 绘制 出 来 的 曲线 与 经 过 平滑 算法 处 理 过 的 曲线 其 圆润 程度 是 不 同 的 。 


Carrier = 


Carrier = 


图 1-4 程序 可 以 实时 地 运用 Catmull-Rom 平 滑 算法 ， 使 连接 触摸 事件 发 生 点 的 弧 可 以 变 得 柔和 一 些 。 两 张 截图 都 是 根据 同一 套 手 势 绘制 的 ， 右 侧 是 运用 了 平滑 算法 之 后 


所 绘制 出 来 的 效果 ， 而 左 侧 则 是 没有 运用 平滑 算法 时 所 绘制 出 来 的 效果 


Catmull-Rom 样 条 插值 法 (Catmull-Rom spline) 可 以 在 天 键 点 (key point) 之 间 创 建 连 续 曲 线 (continuous curve) 。 该 算法 可 以 确保 一 开始 所 提供 的 每 个 


氮 都 出 现在 最 后 绘制 好 的 曲线 上 面 。 运 算 好 的 路 径 能 够 保持 原始 路 径 的 形状 ， 而 开 友 者 则 可 以 决定 在 每 一 对 参考 点 (reference point) 之 间 插 入 多 少 个 中 间 点 。 我 们 
应 该 在 算法 的 计算 量 和 所 能 达到 的 平滑 程度 之 间 进 行 权衡 。 加 入 的 点 越 多 ，CPU 的 资源 消耗 量 束 越 大 。 运 行 本章 附 融 的 范例 代码 之 后 你 就 会 友 现 ， 只 要 稍微 提升 一 下 
平滑 程度 ， 残 能 明显 改善 绘制 效果 ， 即 便 在 新 款 设备 上 也 是 如 此 。 最 新 版 iPad 的 响应 能 力 很 如， 如果 刚 开始 残 想 绘制 一 条 有 校 有 角 的 曲线 ， 还 真 不 是 那么 容易 。 


解决 方案 1-8 演 示 了 如 何 从 现 有 的 贝 塞 尔 曲线 中 提取 一 些 点 ， 以 便 运 用 样 条 插值 法 创建 出 平滑 的 效果 。Catmull-Rom 算 法 每 次 使 用 四 个 点 计算 第 二 点 和 第 三 点 之 间 
的 中 间 值 1， 而 开发 者 可 以 通过 granularity 参 数 来 指定 两 个 点 之 间 到 底 应 该 插入 多 少 个 中 间 点 。 


解决 方案 1-8 ”用 Catmull-Rom 样 条 插值 法 创建 平滑 的 贝 塞 尔 曲 线 


#define VALUE( INDEX ) [NSValue valueWithCGPoint:points[ INDEX ]] 


@implementation UIBezierPath (Points) 
void getPointsFromBezier(void *info, const CGPathElement *element) 


NSMutableArray *bezierPoints = ( bridge NSMutableArray *)info; 


// Retrieve the path element type and its points 
CGPathElementType type = element->type; 
CGPoint *points - element-»points; 


// Add the points if they're available (per type) 
if (type != kCGPathElementCloseSubpath) 
| 
[bezierPoints addObject:VALUE(0)]; 
if ((type != kCGPathElementAddLineToPoint) && 
(type !- kCGPathElementMoveToPoint)) 
[bezierPoints addObject:VALUE(1)]; 
| 
if (type == kCGPathElementAddCurveToPoint ) 
[bezierPoints addObject : VALUE (2) ]; 


- (NSArray *)points 
| 
NSMutableArray *points - [NSMutableArray arrayl; 
CGPathApply (self.CGPath, 
( bridge void *)points, getPointsFromBezier); 
return points; 


| 


@end 


#define POINT( INDEX ) \ 
[(NSValue *)[points objectAtIndex: INDEX ] CGPointValue] 


@implementation UIBezierPath (Smoothing) 

- (UIBezierPath *)smoothedPath: (int) granularity 

{ 
NSMutableArray *points = [self.points mutableCopy] ; 
if (points.count < 4) return [self copy]; 


// Add control points to make the math make sense 

// Via Josh Weinberg 

[points insertObject: [points objectAtIndex:0] atIndex:0] ; 
[points addObject: [points lastObject] ] ; 


UIBezierPath *smoothedPath = [UIBezierPath bezierPath] ; 


// Copy traits 
smoothedPath.lineWidth = self.lineWidth; 


// Draw out the first 3 points (0..2) 
[smoothedPath moveToPoint:POINT(0)]; 


for (int index = 1; index < 3; index++) 
[smoothedPath addLineToPoint:POINT(index)]; 


for (int index = 4; index < points.count; index++) 
{ 

CGPoint pO = POINT(index - 3); 

CGPoint pl = POINT(index - 2); 

CGPoint p2 = POINT(index - 1); 

CGPoint p3 - POINT(index); 


// now add n points starting at pl + dx/dy up 

// until p2 using Catmull-Rom splines 

for (int i s 1; i « granularity; is) 

{ 
float t = (float) i * (1.0f / (float) granularity) ; 
float tt = E * E; 
clost CEt = Ee *" E; 


CGPoint pi; // intermediate point 
pix 0.58 * (2*51l.x-(pD2,Xx-pO.x)wt + 
(2*p0.x-5*pl.x-«4*p2.x-p3.x)*tt + 
(3*p1.x-pO.x-3*p2.x-«p3.x)*ttt); 
pi.y s 0.5 * (2*pil.vy«ip2.v-pO.y)*t = 
(2*pO.y-5*pl.y«4*p2.y-p3.y)*tt + 
(3*pl.y-p0O.y-3*p2.y+p3.y) *ttt) ; 
[smoothedPath addLineToPoint:pi] ; 


} 


// Now add p2 


[smoothedPath addLineToPoint:p2]; 


| 


// finish by adding the last point 
[smoothedPath addLineToPoint:POINT(points.count - 1)]; 


return smoothedPath; 


| 


@end 


// Example usage: 
// Replace the path with a smoothed version after drawing completes 
- (void) touchesEnded: (NSSet *)touches withEvent: (UIEvent *) event 
{ 
UITouch *touch = [touches anyObject]; 
[path addLineToPoint: [touch locationInView:self]]; 
path = [path smoothedPath:4]; 
[self setNeedsDisplay] ; 


解决 方案 1-8 只 不 过 演示 了 一 种 实时 几何 处 理 算法 ， 实 际 上 ， 计 算 几 何 学 里 面 还 有 很 多 算法 都 能 以 类 似 的 方式 运用 到 应 用 程序 中 。 
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具 。 若 想 了 解 更 多 优秀 的 图 形 算 法 ， 请 访问 www.staphicsgems.otg 网 站 ， 查 看 由 Academic Press 9p H ihg «Graphics Gems» 系列 图 书 ， 其 中 也 讲 了 很 多 先进 的 平滑 算法 。 


[1] 这 里 的 第 二 点 和 第 三 点 是 Catmull-Rom 样 条 插值 法 所 使 用 的 特殊 称谓 ， 对 应 于 代码 中 的 p1 和 p2。 一 一 译 者 注 


1.10 ”解决 方案 : 启用 多 点 触摸 


在 UlIView 实 例 中 局 用 了 多 后 触摸 式 的 交互 之 后 ， 当 用 户 以 几 根 手指 同时 触摸 屏幕 时 ，iOS 束 可 以 侦 测 到 这 些 触摸 操作 并 对 其 进行 响应 。 把 UlView 的 
multipleTouchEnabled 属 性 设 为 YES， 或 在 自己 的 视图 类 中 覆 写 isMultipleTouchEnabled 万 法 ， 即 可 局 用 多 点 触 反 。 启 用 之 后 ， 系 统 在 传 给 触摸 回调 方法 的 触摸 事件 
里 面 ， 束 会 放 入 多 个 触摸 对 稍 。 在 触摸 事件 的 设置 中 ， 如 果 有 多 于 一 个 的 元 素 ， 束 说 明 需 要 处 理 多 后 触摸 。 


从 理论 上 来 训 ，iOS 支 持 任 意 多 个 点 的 同时 触摸 。 你 可 以 在 iPad 上 面 运行 解决 方案 1-9， 尽 可 能 用 多 根 手指 同时 触摸 屏幕 ， 看 看 它 的 上 限 是 多 少 。 实 际 的 上 限 以 后 
可 能 会 有 变化 ， 所 以 笔者 不 打算 在 这 个 解决 方案 里 面 给 出 具体 的 个 数 。 


当年 iPhone 首 次 支持 多 后 触摸 的 时 人 息 ， 开 发 者 们 还 没有 预见 到 把 多 后 触摸 同 多 用 尸 操作 结合 起 来 其 实 可 以 实现 出 一 些 自由 而 灵活 的 功能 。 将 多 后 触摸 添加 到 游戏 
及 其 他 应 用 程序 里 面 ， 不 仅 可 以 扩大 手势 的 种 类 ， 而 且 还 能 创造 出 新 闫 而 优秀 的 多 用 户 操 作 体 验 ， 在 配 有 大 屏幕 的 iPad 上 面 更 是 如 此 。 只 要 多 后 触 摸 符 合 应 用 程序 的 
需求 ， 并 且 对 程序 有 帮助 ， 束 可 以 考虑 引入 该 特性 。 


多 后 触摸 并 不 会 按照 用 尸 的 手 来 分 组 。 比 方 说 ， 当 用 户 左 右 两 手 各 用 一 根 手指 触摸 屏幕 时 ， 系 统 无 法 判断 出 某 个 触摸 点 对 应 于 哪 只 手 。 而 且 触 摸 对 象 的 顺序 也 是 
随意 排列 的 。 融 单个 的 触摸 事件 来 说 ， 在 按 下 手指 、 移 动 直至 松 开 的 过 程 中 ， 触 摸 对 象 与 手指 之 间 的 对 应 次 序 保 持 不 变 (说 得 更 具体 些 ， 同 一 个 触摸 对 象 在 内 存 中 的 
地 址 保持 不 变 ) ， 昌 况 如 此 ， 但 是 用 尸 下 次 触摸 屏幕 时 ， 触 措 对 象 与 手指 之 间 不 一 定 还 能 保持 这 套 对 应 天 系 。 如 果 需 要 把 这 些 触摸 对 和 象 分 辨 清楚 ， 那 么 可 以 像 本 条 解 
决 方案 这 样 ， 构 建 一 份 以 触摸 对 象 为 率 引 的 字典 。 

你 要 是 知道 iOS 还 支持 多 于 两 个 手指 的 多 点 触摸 ， 是 不 是 会 完 得 这 个 功能 还 不 错 呢 ?实际 上 ， 如 果 一 次 用 三 根 或 三 根 以 上 的 手指 来 触摸 屏幕 ， 那 么 系统 很 有 可 能 束 
会 漏 掉 某 些 手指 的 触摸 操作 。 假 如 用 两 根 以 上 的 手指 来 操作 程序 ， 那 么 很 难以 编程 的 方式 追踪 到 平滑 的 手势 。 因 此 ， 在 处 理 多 点 触摸 这 种 操作 方式 时 ， 不 要 执著 于 对 
手势 的 解析 ， 而 是 应 该 把 它 理 解 成 一 系列 在 限定 的 时 间 内 友 生 且 各 自 独 立 的 交互 操作 。 你 应 该 把 每 一 个 触摸 对 象 都 当成 各 上 自 独 立 的 东西 来 看 待 ， 并 分 别处 理 它们 。 


解决 方案 1-9 通 过 设 定 multipleTouchEnabled 属 性 来 为 UIView; 添 加 多 点 触摸 功能 ， 并 记录 下 每 根 手 指 所 画 的 线条 。 该 程序 遵照 苹果 公司 的 开 友 建议 ， 记 录 下 每 个 
触摸 对 象 在 内 存 中 的 物理 地 址 ， 并 且 不 使 用 指向 这 些 触摸 对 象 的 捐 针 ， 也 不 对 其 做 保留 (retain) 。 


解决 方案 1-9 ”把 用 尸 所 画 的 各 条 线 收集 起 来 ， 以 实现 鲁 加 式 绘图 


@interface TouchTrackerView : UIView 
- (void) clear; 
@end 


@implementation TouchTrackerView 
NSMutableArray *strokes; 
NSMutableDictionary *touchPaths; 


// Establish new views with storage initialized for drawing 
- (instancetype) initWithFrame: (CGRect) frame 
| 
self - [super initWithFrame:frame]; 
if (self) 
| 
self.multipleTouchEnabled - YES; 
strokes - [NSMutableArray array]; 
touchPaths - [NSMutableDictionary dictionary]; 


| 


return self; 


// On clear, remove all existing strokes, but not in-progress drawing 
- (void)clear 


| 


[strokes removeAllObjects]; 


[self setNeedsDisplay]; 


// Start touches by adding new paths to the touchPath dictionary 
- (void)touchesBegan: (NSSet *)touches withEvent: (UIEvent *)event 


{ 


for (UITouch *touch in touches) 
{ 
NSString *key = [NSString stringWithFormat:@"%d", (int) touch]; 
CGPoint pt = [touch locationInView:self] ; 


UIBezierPath *path = [UIBezierPath bezierPath] ; 
path.lineWidth = IS IPAD ? 8: 4; 
path.lineCapStyle - kCGLineCapRound; 

[path moveToPoint:pt]; 


touchPaths[key] = path; 


} 


// Trace touch movement by growing and stroking the path 
- (void) touchesMoved: (NSSet *)touches withEvent: (UIEvent *) event 


{ 


for (UITouch *touch in touches) 
{ 
NSString *key = 
[NSString stringWithFormat:@"%d", (int) touch]; 
UIBezierPath *path = [touchPaths objectForKey:key]; 
if (!path) break; 


CGPoint pt - [touch locationInView:self]; 
[path addLineToPoint:pt]; 


| 


[self setNeedsDisplay]; 


j 


// On ending a touch, move the path to the strokes array 
- (void)touchesEnded: (NSSet *)touches withEvent: (UIEvent *)event 


{ 


for (UITouch *touch in touches) 
{ 
NSString *key = [NSString stringWithFormat:@"%d", (int) touch] ; 
UIBezierPath *path = [touchPaths objectForKey:keyl; 


if (path) [strokes addObject:path]; 
[touchPaths removeObjectForkKey:key]; 


j 


[self setNeedsDisplay] ; 


- (void) touchesCancelled: (NSSet *)touches withEvent: (UIEvent *)event 


[self touchesEnded:touches withEvent:event] ; 


// Draw existing strokes in dark purple, in-progress ones in light 
- (void)drawRect: (CGRect)rect 


| 


[COOKBOOK PURPLE COLOR set]; 
for (UIBezierPath *path in strokes) 


| 


[path stroke]; 


| 


[ [COOKBOOK PURPLE COLOR colorWithAlphaComponent:0.5f] set]; 
for (UIBezierPath *path in [touchPaths allValues]) 


| 
| 


[path stroke]; 


| 


@end 


本 例 所 及 用 的 做 法 显然 是 比较 奇怪 的 ， 不 过 这 套 办 法 在 各 个 版 本 的 SDK 中 都 能 照常 运作 。 这 是 因为 在 触摸 -移动 -释放 这 个 生命 期 中 ， 每 个 UITouch 对 象 都 驻 留 在 其 
各 自 的 内 存 地 址 处 。 芋 果 公 司 并 不 建议 对 UITouch 实 例 做 保留 ， 所 以 ， 在 本 例 中 ， 我 们 把 这 些 触 措 对 象 转 为 整数 值 ， 并 用 这 些 整数 值 来 作为 字典 的 键 。 


请 注意 ， 每 当 发 生 新 的 触摸 操作 时 ， 系 统 就 会 调用 touchesBegan: withEvent: 来 开启 一 段 新 的 生命 期 ， 这 与 目前 仍 在 进行 中 的 触摸 操作 是 互 不 干扰 的 ， 这 些 操 
作 依 然 可 以 进入 其 各 自 的 移动 、 结 束 及 取消 等 阶段 。 开 发 者 在 编写 代码 时 应 该 考虑 到 这 一 点 。 


这 条 解决 方案 扩充 了 原 有 的 解决 方案 1-7。 每 次 触摸 操作 都 能 独自 产生 一 条 贝 塞 尔 路 径 ， 而 视图 的 drawRect 方 法 则 会 把 这 些 路 径 绘 制 出 来 。 解 决 方案 1-7 在 每 次 触 
摸 操作 的 生命 期 结束 之 后 ， 如 果 友 现 有 新 的 触摸 操作 ， 那 么 就 会 清除 原 有 的 屏幕 内 容 ， 并 开始 绘制 新 的 曲线 。 这 对 于 一 款 仅 用 于 演示 的 应 用 程序 来 说 ， 是 合适 的 ,但 
若 想 创建 一 款 标准 的 绘图 程序 ， 束 不 能 这 么 做 了 ， 而 是 应 该 把 新 绘制 的 内 容 芍 放 到 屏幕 里 原 有 的 内 容 之 上 。 


解决 方案 1-9 不 会 探 除 原 有 的 内 容 ， 新 的 需要 来 清空 此 数组 。 这 个 解决 方案 采用 稍微 淡 一 些 的 颜色 来 绘制 用 户 正 人 在 画 的 线 ， 以 便 与 strokes 数 组 中 已 经 画 好 的 路 径 
相 区 别 。 


Qi 在 苹果 公司 的 开发 者 网 站 上 ， 可 以 找到 很 多 Cote Graphics/Quartz 2D 资 源 。 另 外 还 有 许多 论坛 、 邮 件 列表 及 源 代 码 范 例 ， 它 们 虽然 不 专门 针对 iDOS， 但 也 
都 是 非常 有 价值 的 资源 ， 你 可 以 由 此 来 扩充 自己 的 iDS Core Graphics 知 识 。 


1.11 解决 方案 : 检测 圆圈 手势 


对 于 iOS 这 种 直接 操纵 界面 来 说 ， 开 友 者 可 能 会 党 得 大 部 分 用 户 都 只 是 简单 地 点 击 屏 幕 上 的 物件 。 但 是 ， 有 非常 多 的 人 希望 程序 能 够 支持 圆圈 手势 ， 开 发 者 实现 了 
这 种 手势 之 后 ， 用 户 束 可 以 拿手 措 圈 选 屏 幕 上 的 物件 了 。 有 读者 希望 本 书 给 出 相关 的 解决 方案 ， 于 是 ， 笔 者 编写 了 解决 方案 1-10， 实 现 了 一 个 相对 比较 简单 的 圆圈 手 
势 检 测 器 ， 其 效果 如 图 1-5 所 示 。 
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图 1-5 如果 检测 到 了 圆圈 手势 ， 那 么 程序 会 用 圆 点 及 红 圈 来 描述 该 手势 的 关键 特征 


在 实现 该 程序 的 时 候 ， 笔 者 采用 了 几 个 测试 步 又。 首先 做 时 间 测试 (time test) ， 以 确保 手势 不 能 执行 得 太 慢 。 圆 圈 手 势 应 该 是 一 种 必须 快速 男 出 的 手势 。 接 下 
来 做 弯曲 测试 (inflection test) ， 以 确保 方向 变化 不 能 太 过 频繁 。 一 般 来 况 ， 圆 圈 手 为 的 方向 改变 次 数 是 四 次 ， 本 程序 最 多 人 允许 在 男 圆 过 程 中 变 五 次 方向 。 第 三 种 测 
试 是 履 兰 度 测 试 (convergence test) ， 圆 的 起 点 与 终点 必须 足够 接近 ， 这 两 个 点 必须 要 有 某 种 程度 的 联系 。 由 于 程序 并 不 会 向 用 户 提供 直接 的 视觉 反馈 ， 所 以 用 户 


可 能 会 画 得 稍微 偏 一 点 ， 于 是 ， 我 们 应 该 在 检测 时 留 有 一些 余 地 。 本 程序 所 能 容忍 的 像素 偏差 比较 大 ， 这 个 距离 大 约 是 视图 尺寸 的 1/3。 


解决 方案 1-10 ”检测 圆圈 手势 


// Retrieve center of rectangle 
CGPoint GEORectGetCenter(CGRect rect) 


| 


return CGPointMake (CGRectGetMidX(rect), CGRectGetMidY(rect) ); 


// Build rectangle around a given center 
CGRect GEORectAroundCenter(CGPoint center, float dx, float dy) 


| 


return CGRectMake(center.x - dx, center.y - dy, dx * 2, dy * 2); 


// Center one rect inside another 

CGRect GEORectCenteredInRect (CGRect rect, CGRect mainRect) 

{ 
CGFloat dx CGRectGetMidX (mainRect) -CGRectGetMidX (rect); 
CGFloat dy CGRectGetMidY (mainRect) -CGRectGetMidyY (rect); 
return CGRectOffset(rect, dx, dy); 


// Return dot product of two vectors normalized 
CGFloat dotproduct(CGPoint vl, CGPoint v2) 


| 


CGFloat dot = (vl.x * v2.x) + (vl.y * v2.y); 


CGFloat a = ABS(sqrt(vl.x * vl.x + vl.y * vl.y)); 
CGFloat b ABS(sqrt(v2.x * v2.x + v2.y * v2.y))»; 
dot J= ila. * b] 


H 


return dot; 


// Return distance between two points 
CGFloat distance(CGPoint p1, CGPoint p2) 
{ 
CGFloat dx 
CGFloat dy 


Dea = Bia Xi 
p2.y - pl.yi 


li 


return sqrt (dx*dx + dy*dy); 


// Offset in X 
CGFloat dx(CGPoint p1, CGPoint p2) 


{ 


return Pesce < DIE 


} 


//| Offset in Y 
CGFloat dy(CGPoint pl, CGPoint p2) 


{ 
} 


// Sign of a number 


return p2.y = pLl.y; 


NSInteger sign(CGFloat x) 


{ 


return (x < 0.0£) ? (-1) : 1; 


// Return a point with respect to a given origin 
CGPoint pointWithOrigin(CGPoint pt, CGPoint origin) 


{ 
} 


return CGPointMake(pt.x - origin.x, pt.y - origin.y) ; 


// Calculate and return least bounding rectangle 
#define POINT( INDEX ) [(NSValue *) [points \ 
objectAtIndex: INDEX_] CGPointValue] 


CGRect boundingRect (NSArray *points) 


{ 


CGRect rect = CGRectZero; 
CGRect ptRect; 


for (NSUInteger i = 0; i « points.count; i++) 


{ 


CGPoint pt = POINT(i); 


ptRect = CGRectMake(pt.x, pt.y, 0.0£, 0.O£); 
rect = (CGRectEqualToRect (rect, CGRectZero)) ? 
ptRect : CGRectUnion(rect, ptRect) ; 


| 


return rect; 


CGRect testForCircle(NSArray *points, NSDate *firstTouchDate) 
{ 


lf (ports <Gounmt < 2) 

{ 
NSLog(@"Too few points (2) for circle"); 
return CGRectZero; 


// Test 1: duration tolerance 

float duration - [[NSDate date] 

timelntervalSinceDate:firstTouchDate]; 
NSLog(G"Transit duration: $0.2f", duration); 


float maxDuration - 2.0f; 

if (duration > maxDuration) 
NSLog(G"Excessive duration"); 
return CGRectZero; 


j 


// Test 2: Direction changes should be limited to near 4 
int inflections = 0; 
for (int 1 = 2; 2 « (points.count = 1); It) 


| 


F 
F 


Li 


float deltx - dx(POINT(i), POINT(i-1 
float delty = dy(POINT(i), POINT(i- 


) 
13 
float px = dx(POINT(i-1), POINT(i-2)) 
)) 


float py = dy(POINT(i-1), POINT(i-2)); 

if ((sign(deltx) != sign(px)) || 
(sign(delty) l= sign(py) )) 
inflections++; 


| 


if (inflections » 5) 
NSLog(G"Excessive inflections"); 
return CGRectZero; 


// Test 3: Start and end points near each other 

float tolerance = [[[UIApplication sharedApplication] 
keyWindow] bounds].size.width / 3.0f; 

if (distance(POINT(0), POINT(points.count - 1)) » tolerance) 


NSLog(G"Start too far from end"); 
return CGRectZero; 


// Test 4: Count the distance traveled in degrees 

CGRect circle - boundingRect (points); 

CGPoint center - GEORectGetCenter(circle); 

float distance = ABS (acos (dotproduct ( 
pointWithOrigin(POINT(0), center), 
pointWithOrigin(POINT(1), center)))); 

for (int i = 1; i « (points.count - 1); i++) 

distance += ABS (acos (dotproduct( 


pointWithOrigin(POINT(i), center), 
pointWithOrigin(POINT(i«1), center)))); 


float transitTolerance - distance - 2 * M PI; 


if (transitTolerance « 0.0f) // fell short of 2 PI 


| 


if (transitTolerance < - (M PI / 4.0f)) // under 45 


| 


NSLog(G"Transit too short"); 
return CGRectZero; 


if (transitTolerance » M PI) // additional 180 degrees 


| 


NSLog(G"Transit too long "); 
return CGRectZero; 


return circle; 


| 


@end 
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加 的 时 候 能 把 手势 做 得 自然 一 些 ,我 们 扩大 了 对 角度 的 容忍 范围 ， 用 户 最 少 可 以 少 画 45 度 ， 最 多 可 以 多 男 180 度 。 


如 果 这 些 测试 全 都 通过 了 ， 那 么 该 算法 丈 生 成 一 个 最 小 外 接 和 矩形 (least bounding rectangle) ， 并 对 原 手势 上 的 各 点 求 几何 平均 值 ， 然 后 把 矩形 中 心 点 与 均值 点 
对 齐 。 程 序 会 把 检测 结果 赋 给 circle 变 量 。 这 套 检 测 系统 虽然 不 完美 (读者 可 以 运行 范例 代码 ， 并 想 办 法 驻 过 这 套 检测 系统 ) ， 但 它 却 能 为 许多 iOS 应 用 程序 提供 足够 
健壮 而 且 相 当 好 用 的 圆圈 手势 检测 能 力 。 


1.12 解决 万 案 : 创建 目 定 义 手 势 识 别 器 


只 需 稍 加 修改 ， 区 能 把 解决 方案 1-10 中 的 代码 转换 成 一 款 可 以 辨识 自 定义 手势 的 识别 器 ， 解 决 方案 1-11 实 现 了 这 种 识别 器 。 从 UIGestureRecognizer 中 继承 子 
类 ， 即 可 构建 出 自己 的 圆圈 手势 识别 器 ， 然 后， 可 以 将 其 添加 a 到 自己 的 应 用 程序 中 。 


你 应 该 在 自己 的 新 类 里 面 引 入 UIKit 的 UlGestureRecognizerSubclass.h。 实 现 UlGestureRecognizer 的 子 类 时 ， 可 能 需要 履 写 或 自 定义 一 些 方法 ， 而 这 些 方法 都 
声明 在 UlGestureRecognizerSubclass.h 头 文件 里 。 在 履 写 某 个 方法 时 ， 你 应 该 先 调用 该 方法 的 原始 版 本 ， 然 后 再 执行 自己 的 新 代码 ， 也 就 是 说 ， 应 该 先 调 用 超 类 的 同 
名 方法 。 


手势 可 以 分 为 两 大 类 : 连续 手势 (continuous gesture) 和 不 连续 手势 (discrete gesture) 。 圆 圈 手 势 识 别 器 就 是 不 连续 的 。 它 要 么 可 以 识别 出 圆圈 手势 ， 要 么 
识别 不 出 来 。 而 双 指 聚拢 及 拖 动 则 属于 连续 手势 ， 手 势 识别 器 会 在 手势 的 整个 生命 期 里 面 不 断 发 送 相关 的 更 新 。 手 势 识别 器 通过 设置 state 属 性 来 产生 更 新 。 


手势 识别 器 其 实 融 是 个 描述 指 尖 状态 的 状态 机 。 每 个 识别 器 刚 开 始 都 处 在 possible 状 态 (UlGestureRecognizerStatePossible) ， 对 于 连续 手势 来 说， 识别 器 会 
历经 一 系列 的 changed 状 态 (UlGestureRecognizerStateChanged) ， 而 对 于 不 连续 手势 来 说 ， 如 果 能 够 识别 出 这 样 的 手势 ， 那 么 识别 器 就 会 进入 
UlGestureRecognizerStateRecognized 状 态 ， 若 识别 不 出 来 ， 则 进入 UlGestureRecognizerStateFailed 状 态 ， 如 解决 方案 1-11 所 示 。 除 非 我 们 将 状态 (state) 设 为 
possible 或 failed， 否 则 每 次 更 新 状态 的 时 候 ， 识 别 器 都 会 向 其 目标 发 送 动作 消息 。 


解决 方案 1-11 创建 UIGestureRecognizer 的 子 类 


#import <UIKit/UIGestureRecognizerSubclass.h> 
@implementation CircleRecognizer 


// Called automatically by the runtime after the gesture state has 

// been set to UIGestureRecognizerStateEnded. Any internal state 

// should be reset to prepare for a new attempt to recognize the gesture. 
// After this is received, all remaining active touches will be ignored 
// (no further updates will be received for touches that had already 

// begun but haven't ended). 

- (void)reset 


| 


[super reset]; 


points e nil; 
firstTouchDate - nil; 
self.state = UIGestureRecognizerStatePossible; 


// mirror of the touch-delivery methods on UIResponder 
// UIGestureRecognizers aren't in the responder chain, but observe 
// touches hit-tested to their view and their view's subviews. 


// UIGestureRecognizers receive touches before the view to which 
// the touch was hit-tested. 
- (void)touchesBegan: (NSSet *)touches withEvent: (UIEvent *) event 


| 


[super touchesBegan:touches withEvent:event]; 
if (touches.count » 1) 


self.state - UIGestureRecognizerStateFailed; 


return; 


points - [NSMutableArray arrayl; 

[NSDate date]; 

UITouch *touch = [touches anyObject] ; 

[points addObject: [NSValue valueWithCGPoint: 
[touch locationInView:self.view] ]]; 


firstTouchDate 


- (void) touchesMoved: (NSSet *)touches withEvent: (UIEvent *) event 


[super touchesMoved:touches withEvent:event] ; 

UITouch *touch = [touches anyObject] ; 

[points addObject: [NSValue valueWithCGPoint: 
[touch locationInView:self.view]]]; 


- (void) touchesEnded: (NSSet *)touches withEvent: (UIEvent *) event 


[super touchesEnded:touches withEvent: event]; 
BOOL detectionSuccess - !CGRectEqualToRect (CGRectZero, 
testForCircle(points, firstTouchDate)); 
if (detectionSuccess) 
self.state - UIGestureRecognizerStateRecognized; 
else 
self.state = UIGestureRecognizerStateFailed; 


| 


@end 


解决 方案 1-11 里 面 有 几 段 相当 长 的 注释 ， 那 是 笔者 从 UIGestureRecognizerSubclass.h 头 文件 里 面 拷 贝 过 来 的 ， 感 谢 苹果 公司 撰写 这 些 注释 。 它 们 分 别 解释 了 几 
个 关键 的 方法 所 扮演 的 角色 ， 我 们 在 UIGestureRecognizer 子 类 里 覆 写 了 这 几 个 方法 。reset 方 法 会 令 识别 器 回 到 沉 我 (quiescent) 状态 ， 以 便 为 识别 下 一 轮 手势 做 准 
备 。 

与 UIResponder 中 的 相关 方法 类 似 ， 识 别 器 也 会 在 相应 的 时 机 调用 touchesBegan: withEvent: 等 方法 ， 这 使 得 开发 者 可 以 在 识别 器 里 面 编写 代码 ， 在 触摸 操作 
生命 期 中 的 相关 时 间 点 上 执行 测试 。 本 范例 程序 会 一 直 等 到 系统 调用 touchesEnded: withEvent: 回调 方法 时 ， 再 去 判断 对 手势 的 识别 是 成 功 了 还 是 失败 了 ， 它 所 用 
的 testForCircle 方 法 与 解决 方案 1-10 中 定义 的 方法 相同 。 

Qi 作为 履 写 超 类 方法 时 所 应 提倡 的 一 条 原则 ， 一 旦 发 现 无 法 辨识 出 手势 ， 我 们 就 应 该 令 手 势 识 别 器 尽快 “失败 ”。 若 是 能 够 辨识 出 手势 ， 就 应 当 把 与 手势 
有 关 的 信息 存储 在 程序 的 属性 里 面 。 圆 圈 手 势 识 别 器 应 该 把 检测 到 的 圆圈 保存 起 来 ， 使 用 户 能 够 知道 手势 出 现在 何 处 。 


1.13 ”解决 方案 : BRAES EREN 


iOS 所 提供 的 手势 识别 器 的 功能 确实 很 丰富 ， 但 并 不 总 是 能 够 满足 开 友 者 的 需要 。 比 方 说 ， 有 个 可 以 水 平 滚动 的 视图 ， 里 面包 含 许多 相 邻 的 图 像 视图 
ImageView， 用 尸 可 以 左右 滚动 这 个 大 视图 来 查看 其 中 的 全 部 内 容 。 现 在 ,假设 我 们 要 实现 一 个 功能 ， 令 用 户 可 以 把 视图 中 的 ImageView 拖 蝶 到 深 动 区 域 下 方 的 空 日 
区 域 里 。 想 实现 此 功能 ,我 们 需要 辨识 友 生 在 每 个 子 视图 身上 的 向 下 触摸 操作 (downward touch， 其 移动 的 方向 与 大 视图 的 滚动 方向 相 垂 直 ) . 
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区 中 ， 然 后 可 以 操作 并 排列 其 所 选 的 字母 。 实 现 这 种 功能 的 时 候 ， 要 解决 两 个 问题 : 一 是 触摸 操作 属于 谁 来 管 ， 二 是 识别 出 了 向 下 触摸 之 后 应 该 怎样 处 理 。 


滚动 视图 (Scroll View) 中 的 子 视图 都 需要 关注 触摸 操作 。 如 果 检 测 到 了 向 下 的 手势 ， 那 么 程序 就 应 该 产生 新 对 象 ， 若 是 检测 到 横向 的 手势 ， 则 应 该 水 平 滚动 滚 
动 视图 中 的 内 容 。 为 了 使 深 动 视图 及 其 子 视图 都 能 响应 用 户 的 操作 ， 我 们 应 该 在 程序 内 部 共享 触摸 信息 。 经 由 UlGestureRecognizerDelegate 即 可 实现 这 一 点 。 


开发 者 通过 UlGestureRecognizerDelegate 可 以 实现 同步 识别 ， 也 就 是 这， 两 个 手势 识别 器 可 以 同时 运作 。 要 想 实 现 这 一 点 ， 只 需 令 相关 的 类 遵从 
UlGestureRecognizerDelegate 协 议 ， 并 向 其 中 添加 下 面 这 个 简单 的 委托 方法 : 


(BOOL)gestureRecognizer: (UIGestureRecognizer *)gestureRecognizer 
shouldRecognizeSimultaneouslyWithGestureRecognizer: 
(UIGestureRecognizer *)otherGestureRecognizer 


return YES; 


| 

由 于 我 们 不 能 重新 设置 滚动 视图 的 委托 ， 所 以 必须 令 滚动 视图 里 面 的 子 视图 所 对 应 的 类 遵循 UlIGestureRecognizerDelegate 协 议 ， 并 在 其 中 实现 上 述 方法 。 

要 想 解决 上 面 所 提 的 第 二 个 问题 ， 也 就 是 如 何 令 滑动 这 个 动作 产生 出 拖 蝶 效果 ， 需 要 从 整个 触摸 生命 期 的 角度 来 考虑 。 凡 是 能 产生 新 对 象 的 触摸 操作 ， 一 开始 都 
是 一 个 素 直 方向 上 的 拖 忠 ， 但 只 要 新 对 象 创建 出 来 了 ， 它 束 变 成 了 拖 动 手势 。 所 以 ， 此 处 使 用 拖 动 手势 识别 器 更 为 合适 ， 因 为 假如 使 用 滑动 手势 识别 器 的 话 ， 那 么 等 
识别 出 来 的 时 候 ， 触 摸 操作 的 生命 期 已 经 结束 了 。 

为 了 解决 第 二 个 问题 ， 解 决 方案 1-12 在 内 置 的 手势 探测 代码 中 实现 了 对 方位 移动 |/ 的 检测 。 从 最 后 的 结果 来 看 ， 这 种 打破 常规 的 做 法 收 到 了 实效 。 这 是 因为 程序 
检测 到 滑动 之 后 ， 底 层 的 拖 动 手势 识别 器 依然 会 继续 运作 。 如 此 一 来 ， 用 户 束 可 以 继续 移动 刚才 拖 蝶 出 来 的 物件 ， 而 无 须 先 把 手指 拾 起 来 ， 然 后 再 重新 触摸 它 。 


解决 方案 1-12 ”把 滚动 视图 中 的 物件 拖 蝶 到 外 面 


Gimplementation DragView 


#define DX(pl, p2) (p2.X - pl.x) 
#define DY(pl, p2) (p2.y - pl.y) 


const NSInteger kSwipeDragMin - 16; 
const NSInteger kDragLimitMax - 12; 


// Categorize swipe types 

typedef enum { 
TouchUnknown, 
TouchSwipeLeft, 
TouchSwipeRight, 
TouchSwipeUp, 
TouchSwipeDown, 

) SwipeTypes; 


@implementation PullView 


// Cxeate a new view with an embedded pan gesture recognizer 
- (instancetype)initWithImage: (UIImage *)anImage 
| 

self - [super initWithImage:anImage]; 

if (self) 

| 


self.userInteractionEnabled 
UIPanGestureRecognizer *pan - 


YES: 


[[UIPanGestureRecognizer alloc] initWithTarget:self 


action:@selector (handlePan:)]; 
pan.delegate - self; 


self.gestureRecognizers = @[pan] ; 


// Allow simultaneous recognition 
- (BOOL) gestureRecognizer: (UIGestureRecognizer *)gestureRecognizer 
shouldRecognizeSimultaneouslyWithGestureRecognizer: 
(UIGestureRecognizer *)otherGestureRecognizer 


return YES; 


| 


// Handle pans by detecting swipes 
- (void)handlePan: (UISwipeGestureRecognizer *)uigr 


| 


// Only deal with scroll view superviews 


if (![self.superview isKindOfClass:[UIScrollView class]]) return; 


// Extract superviews 
UIView *supersuper - self.superview.superview; 
UIScrollView *scrollView - (UlScrollView *) self.superview; 


// Calculate location of touch 
CGPoint touchLocation - [uigr locationInView:supersuper]; 


// Handle touch based on recognizer state 


if (uigr.state == UIGestureRecognizerStateBegan) 


{ 


// Initialize recognizer 
gestureWasHandled = NO; 


pointCount = 1j 
StartPoint s touchLocation; 

if(uigr.state -- UlGestureRecognizerStateChanged) 
pointCount++; 


// Calculate whether a swipe has occurred 
float dx = DX(touchLocation, startPoint) ; 
float dy = DY(touchLocation, startPoint); 


BOOL finished - YES; 

if ((dx » kSwipeDragMin) && (ABS(dy) « kDragLimitMax)) 
touchtype - TouchSwipeLeft; 

else if ((-dx » kSwipeDragMin) && (ABS(dy) « kDragLimitMax)) 
touchtype - TouchSwipeRight; 

else if ((dy > kSwipeDragMin) && (ABS(dx) < kDragLimitMax)) 
touchtype - TouchSwipeUp; 

else if ((-dy » kSwipeDragMin) && (ABS(dx) « kDragLimitMax)) 
touchtype - TouchSwipeDown; 

else 
finished - NO; 


// If unhandled and a downward swipe, produce a new draggable view 
if (!gestureWasHandled && finished && 


(touchtype -- TouchSwipeDown)) 

{ 
dragView = [[DragView alloc] initWithImage:self.image] ; 
dragView.center = touchLocation; 


[supersuper addSubview: dragView] ; 
scrollView.scrollEnabled = NO; 
gestureWasHandled = YES; 


} 


else if (gestureWasHandled) 


// allow continued dragging after detection 
dragView.center - touchLocation; 


if(uigr.state -- UlGestureRecognizerStateEnded) 


// ensure that the scroll view returns to scrollable 
if (gestureWasHandled) 
scrollView.scrollEnabled - YES; 


| 


@end 


解决 方案 1-12 中 的 实现 代码 在 认定 滑动 操作 时 ， 所 用 的 标准 是 垂直 方向 至 少 扫 过 16 个 像素 ， 而 且 左右 两 侧 的 偏离 不 能 超过 12 个 像素 。 如 果 代码 检测 到 了 这 种 向 下 
的 滑动 ， 那 么 它 融 把 新 建 的 DragView 对 象 (本 章 前 面 曾 经 用 过 DragView 类 ) 添加 到 屏幕 中 ， 使 该 对 象 可 以 随 着 用 户 的 触摸 而 完成 接 下 来 的 拖 动 手势 交互 过 程 。 


一 旦 识别 出 向 下 的 滑动 操作 ，PullView 类 就 把 自己 的 gestureWasHandled 标 注 成 TRUE， 意 思 是 说 ， 自 己 已 经 把 这 个 滑动 处 理 过 了 ， 同 时 ， 它 还 会 在 继续 处 理 本 
次 拖 动 事 件 的 过 程 中 禁用 ScrollView。 这 样 的 话 ， 用 户 所 拖 蝶 的 子 视图 就 可 以 完全 掌控 当前 拖 动 手势 的 交互 过 程 ， 而 Scroll View 也 就 不 用 再 处 理 接 下 来 的 触摸 移动 
Ee 


[1] ditectional-movement， 也 就 是 上 、 下 、 左 、 右 四 个 方向 上 的 移动 。 译 者 注 


1.14 解决 方案 : 实时 的 触摸 反馈 


你 有 没有 给 jiOs 应 用 程序 录制 过 demo 呢 ”如 果 要 录制 的 话 ， 辟 会 遇 到 个 两 难 的 问题 。 一 种 办 法 是 对 痢 手 机 屏幕 来 录制 ， 这 样 做 的 缺点 是 可 能 会 把 手机 屏幕 上 反射 
的 影像 录 进 去 ， 而 且 用 户 的 手 还 可 能 会 挡住 屏幕 。 另 一 种 做 法 是 使 用 Reflection (http://reflectionapp.com) 之 类 的 工具 ， 但 是 这 些 工具 只 能 把 直接 发 生 在 iOS 设 备 
屏幕 上 的 内 容 录 下 来 ， 没 有 办 法 录 下 用 户 触摸 应 用 程序 的 情况 ， 也 没 办 法 专门 对 某 个 部 分 进行 特写 。 


解决 方案 1-13 提 供 了 一 套 简 单 的 类 (它们 统称 为 TOUCHkit) ， 使 程序 可 以 具备 实时 的 触摸 反馈 层 ， 以 供 开 上 友 者 向 他 人 演示 该 程序 的 用 法 。 有 了 这 项 功能 之 后 ， 你 
既 可 以 看 到 要 录制 的 屏幕 ， 也 可 以 看 到 引 友 互动 效果 的 触 措 操 作 ， 而 那些 互动 效果 正 是 你 想 要 展示 给 大 家 看 的 。TOUCHKkit 提 供 了 一 种 方式 ， 使 开 友 者 可 以 编译 出 两 个 
版 本 的 程序 ， 一 种 供 普 通 场合 使 用 ， 另 一 种 供 演 示 用 。 无 论 制 作 哪个 版 本 ， 都 不 用 改变 核心 的 应 用 程序 。 你 只 需 简 单 切换 一 下 ， 融 能 构建 出 这 两 种 不 同 用 途 的 版 本 。 


为 了 说 明 TOUCHKkit 的 用 法 ， 笔 者 找 了 一 款 由 苹果 公司 所 制作 的 标准 演示 程序 ， 并 把 它 的 范例 代码 连同 本 节 的 范例 代码 一 并 放 在 解决 方案 1-13 之 中 。 学 会 这 套 工 具 
包 的 用 法 之 后 ， 你 基本 上 融 可 以 把 它 运 用 到 各 种 标准 的 应 用 程序 上 面 了 。 


1.14.1 “局 用 触摸 反馈 效果 


右 想 为 现 有 程序 添加 触摸 反 馈 效果 ， 只 需 切 换 TOUCHkit 中 的 相关 特性 ， 这 不 会 影响 到 普通 的 应 用 程序 代码 。 设 定好 相关 标志 之 后 ， 融 可 以 编译 并 构建 应 用 程序 
了 ， 用 户 在 触 措 这 种 程序 时 ， 屏 幕 上 会 出 现 玛 加 效果 ， 开 妈 者 可 以 拿 这 种 程序 做 演示 用 。 部 署 到 App Store 的 时 候 ， 则 应 该 将 该 标志 禁用 。 茜 用 之 后 ， 应 用 程序 的 行为 
就 恢复 正常 了 ， 而 且 开 发 者 也 无 须 担心 程序 会 执行 App Store 所 认定 的 不 安全 调用 : 


#define USES TOUCHkit 1 


本 条 解决 方案 假定 开 友 者 所 构建 的 程序 是 只 有 一 个 主 窗口 的 标准 应 用 程序 。 编 译 的 时 候 ，TOUCHKkit 会 用 一 个 自 定 义 的 类 来 取代 窗口 类 ， 而 自 定 义 的 类 可 以 捕获 并 
复制 所 有 的 触摸 操作 ， 这 束 使 得 应 用 程序 能 够 用 气泡 标志 来 表示 用 尸 的 触摸 后 。 


另外 ， 开 友 者 还 需要 做 一 次 非常 重要 的 代码 修改 操作 ， 不 过 所 涉及 的 代码 量 非常 少 。 在 应 用 程序 委托 类 中 ， 需 要 定义 WINDOW_CLASS,， 构建 iOS 应 用 程序 的 窗口 


时 会 用 到 它 。 


Hif USES TOUCHkit 

Himport "TOUCHkitView.h" 

#import "TOUCHOverlayWindow.h" 

#define WINDOW CLASS TOUCHOverlayWindow 
#else 

#define WINDOW CLASS UIWindow 

#endif 


定义 好 WINDOW _CLASS 之 后 ， 我 们 不 直接 使 用 UIWindow， 而 是 根据 WINDOW CLASS 来 决定 具体 使 用 哪个 类 : 


WINDOW CLASS *window; 
window - [[WINDOW CLASS alloc] 
initWithFrame:[[UIScreen mainScreen] bounds]]; 


现在 ， 你 就 可 以 像 往常 那样 设置 窗口 的 rootViewController 属 性 了 。 


1.14.2 ”拦截 并 转 友 触摸 事件 


TOUCHkit 之 所 以 能 在 屏幕 上 实现 触摸 反馈 效果 ， 是 因为 它 拦截 了 触摸 事件 ， 并 据 此 在 应 用 程序 通常 的 界面 上 方 创建 了 苇 加 图 样 ， 然 后 又 把 事件 转 友 给 了 应 用 程 
序 。TOUCHkit 的 视图 位 于 程序 原来 的 界面 之 上 ， 而 自 定 义 的 窗口 类 则 可 以 抓 取 用 尸 的 触摸 事件 ， 并 将 其 以 圆圈 的 形式 展示 到 TOUCHKkit 的 视图 上 面 。 然 后 ， 它 会 把 事 
件 转发 给 程序 ， 这 样 看 上 去 就 好 像 是 用 户 直 接 在 和 普通 的 UIWindow 交 互 一 样 。 本 条 解决 方案 将 使 用 事件 转发 来 实现 这 一 点 。 


事件 转发 是 通过 调用 另外 一 个 事件 处 理 程序 来 完成 的 。TOUCHOverlayWindow 类 覆 写 了 UIWindow 的 sendEvent: 方法 ， 以 便 把 触摸 效果 绘制 到 屏幕 上 面 ， 然 
后 ， 该 方法 会 调用 超 类 的 同名 方法 ， 以 便 将 控制 权 交 还 给 普通 的 响应 者 链 。 


下 面 的 实现 代码 是 根据 苹果 公司 的 《Event Handling Guide for iOS》 而 编写 的 。 它 会 把 与 当前 事件 有 关 的 全 部 UITouch 都 收集 起 来 ， 这 样 一 来 ， 无 论 是 多 点 触 
摸 还 是 单 点 触摸 ， 我 们 都 能 够 应 对 。 然 后 ， 该 方法 会 将 其 派发 给 TOUCHkit 的 TOUCHkitView， 最 后 ， 它 调用 通常 的 UlWindow sendEvent: 实现 代码 ， 将 事件 转 给 


@implementation TOUCHOverlayWindow 

- (void)sendEvent: (UIEvent *)event 

{ 
// Collect touches 
NSSet *touches = [event allTouches] ; 
NSMutableSet *began = nil; 
NSMutableSet *moved = nil; 
NSMutableSet *ended = nil; 
NSMutableSet *cancelled = nil; 


// Sort the touches by phase for event dispatch 
for(UITouch *touch in touches) { 
switch ([touch phase]) | 
case UITouchPhaseBegan: 


if (!began) began = [NSMutableSet set]; 
[began addObject:touch] ; 
break; 


case UITouchPhaseMoved: 
if (!moved) moved = [NSMutableSet set]; 
[moved addObject:touch] ; 


break; 
case UITouchPhaseEnded: 
if (!ended) ended = [NSMutableSet set]; 
[ended addObject:touch] ; 
break; 


case UITouchPhaseCancelled: 
if (!cancelled) cancelled - [NSMutableSet set]; 
[cancelled addObject:touch]; 
break; 
default: 
break; 


// Create pseudo-event dispatch 
if (began) 
[[TOUCHkitView sharedInstance] 
touchesBegan:began withEvent:event]; 
if (moved) 
[[TOUCHkitView sharedInstance] 
touchesMoved:moved withEvent:event]; 
if (ended) 
[[TOUCHkitView sharedInstance] 
touchesEnded:ended withEvent:event]; 
if (cancelled) 
[[TOUCHkitView sharedInstance] 


touchesCancelled:cancelled withEvent:event]; 


// Call normal handler for default responder chain 
[super sendEvent: event]; 


| 


@end 


1.14.3 SEHITOUCHkitHYTOUCHkitViewZs 


TOUCHkit 的 TOUCHKkitView 是 个 简单 而 清晰 的 UIView 单 例 。 当 应 用 程序 首次 请 求 访问 该 类 的 共享 实例 时 ， 它 才 会 创建 sharedlnstance， 创 建 的 时 候 ， 该 类 会 把 
sharedlnstance 添 加 到 程序 的 key window 之 中 。 由 于 TOUCHKkitView 的 userlnteractionEnabled 标 志 是 NO， 所 以 即便 我 们 通过 标准 的 touchesBegan、 
touchesMoved、touchesEnded 及 touchesCancelled 等 事件 回调 方法 处 理 了 这 些 事件 ， 它 们 也 依然 能 够 继续 向 后 传播 ， 并 到 达 TOUCHkitView 下 方 的 界面 里 ， 使 得 


系统 可 以 将 其 纳入 响应 者 链 。 


处 理 触 摸 事件 的 方法 会 在 每 个 触摸 点 上 绘制 一 个 圆圈 ， 并 创建 一 个 指向 theTouches 的 强 指针 (strong pointer) ， 待 绘制 完成 之 后 ， 再 清空 该 指针 


13 详 细 介 绍 了 处 理 该 功能 的 回调 和 绘制 方法 。 


解决 方案 1-13 ”创建 TOUCHkitView 类 ， 以 绘制 触摸 反馈 效果 


@implementation TOUCHkitView 


| 


T 


| 


| 


NSSet *touches; 
UIImage *fingers; 


(instancetype)sharedInstance 


// Create shared instance if it does not yet exist 
if(!sharedInstance) 


sharedInstance = [[self alloc] initWithFrame:CGRectZero] ; 


// Parent it to the key window 

if (!sharedInstance.superview) 

| 
UIWindow *keyWindow = [UIApplication sharedApplication].keyWindow; 
sharedInstance.frame - keyWindow.bounds; 
[keyWindow addSubview:sharedInstance]; 


return sharedInstance; 


// You can override the default touchColor if you want 


(instancetype)initWithFrame: (CGRect)frame 


。 解 决 方案 1- 


self - [super initWithFrame:frame]; 

if (self) 

{ 
self .backgroundColor = [UIColor clearColor] ; 
self.userInteractionEnabled = NO; 
self.multipleTouchEnabled = YES; 
touchColor = 

[ [UIColor whiteColor] colorWithAlphaComponent:0.5f]; 

touches - nil; 


} 


return self; 


} 


// Basic touches processing 
- (void) touchesBegan: (NSSet *)theTouches withEvent: (UIEvent *) event 
{ 

touches = theTouches; 

[self setNeedsDisplay] ; 


- (void) touchesMoved: (NSSet *)theTouches withEvent: (UIEvent *) event 
{ 

touches = theTouches; 

[self setNeedsDisplay] ; 


- (void) touchesEnded: (NSSet *)theTouches withEvent: (UIEvent *) event 
{ 

touches = nil; 

[self setNeedsDisplay] ; 


// Draw touches interactively 

- (void) drawRect: (CGRect) rect 
// Clear 
CGContextRef context = UIGraphicsGetCurrentContext () ; 
CGContextClearRect (context, self.bounds); 


// Fill see-through 
[[UIColor clearColor] set]; 
CGContextFillRect(context, self.bounds); 


float size = 25.0f; // based on 44.0f standard touch point 


for (UlTouch *touch in touches) 

{ 
// Create a backing frame 
[[[UIColor darkGrayColor] colorWithAlphaComponent:0.5f] set]; 
CGPoint aPoint - [touch locationInView:self]; 
CGContextAddEllipseInRect (context, 


CGRectMake(aPoint.x - size, aPoint.y - size, 2 * size, 2 * size)); 
CGContextFillPath(context); 


// Draw the foreground touch 
float dsize = 1.0f; 
[touchColor set]; 
aPoint - [touch locationInView:self]; 
CGContextAddEllipseInRect (context, 

CGRectMake(aPoint.x - size - dsize, aPoint.y - size - dsize, 

2 * (size - dsize), 2 * (size - dsize))); 

CGContextFillPath(context); 


// Reset touches after use 
touches - nil; 


1.15 ”解决 方案 : 向 视图 中 添加 菜单 


UIMenuController 类 使 得 开发 者 可 以 向 身 为 第 一 响应 者 的 任何 物件 之 中 添加 弹出 式 菜单 。 一 般 来 说 ,菜单 是 与 文本 视图 (Text View) 及 文本 框 (Text Field) 结 
合 起 来 使 用 的 ， 它 使 得 用 户 能 够 执行 选取 、 拷 贝 及 粘贴 等 操作 。 另 外 ， 开 发 者 也 可 通过 菜单 来 提供 与 互动 式 屏幕 元 件 有 关 的 操作 ， 例 如 ， 可 以 像 本 章 这 样 ， 通 过 菜单 
来 操作 程序 里 的 小 DragView。 图 1-6 演 示 了 一 套 自 定义 的 菜单 。 在 解决 方案 1-14 中 ， 如 果 用 户 长 按 某 一 打 伦 ， 程 序 就 会 展示 出 一 组 菜单 。 用 户 可 以 经 由 其 中 的 菜单 项 
对 当前 的 DragView 执 行 缩放 、 旋 转 或 隐藏 等 操作 。 


Randomize 


| M 


A1-6 ”开发 者 可 以 通过 弹出 式 关联 菜单 给 充当 第 一 响应 者 的 视图 添加 交互 操作 


RAR Se daB RADBZXBGESESRJUIMenu-Controller, ARMAS AM, FRBSSRE SNA (一 般 来 襄 ， 需 要 传 入 自己 的 bounds 
以 及 展示 该 菜单 的 视图 ) ， 并 调整 菜单 的 箭头 方向 ， 然 后 调用 菜单 的 update 方 法 ， 使 我 们 对 菜单 所 做 的 修改 能 够 生效 。 执 行 完 这 些 操作 之 后 ， 就 可 以 把 菜单 设 为 可 见 
状态 了 。 


菜单 项 也 有 其 标准 的 目标 -动作 回调 机 制 ， 但 我 们 并 不 需要 直接 设置 目标 。 目 标 总 是 身 为 第 一 响应 者 的 视图 。 本 条 解决 方案 没有 在 响应 者 上 面 执行 
canPerformAction: withSender: 检测 ， 不过， 若是 你 的 程序 里 面 某 些 视图 可 以 支持 特定 的 动作 ， 而 另外 一 些 视图 不 能 ， 那 么 就 需要 湛 加 这 种 检测 了 。 是 否 能 支持 
某 项 菜单 所 对 应 的 操作 一 般 和 视图 的 状态 有 关 。 比 方 说 ， 假 如 视图 里 面 没有 内 容 可 供 拷 贝 ， 那 么 我 们 就 不 应 该 提供 拷贝 (copy) 命令 


Xo 


解决 方案 1-14 ”向 互动 式 的 视图 中 添加 菜单 


(BOOL) canBecomeFirstResponder 


// Menus only work with first responders 
return YES; 


- (void)pressed: (UILongPressGestureRecognizer *)recognizer 


if (![self becomeFirstResponder] ) 


| 


NSLog(@"Could not become first responder"); 
return; 


UIMenuController *menu = [UIMenuController sharedMenuController]; 
UIMenuItem *pop - [[UIMenuItem alloc] 

initWithTitle:@"Pop" action:Gselector(popSelf)]; 
UIMenuItem *rotate - [[UIMenuItem alloc] 

initWithTitle:G"Rotate" action:Gselector(rotateSelf)]; 
UIMenuItem *ghost = [[UIMenuItem alloc] 

initWithTitle:@"Ghost" action:@selector(ghostSelf)]; 
[menu setMenultems:e[pop, rotate, ghost]]; 


[menu setTargetRect:self.bounds inView:self] ; 
menu.arrowDirection = UIMenuControllerArrowDown ; 
[menu update]; 

[menu setMenuVisible: YES] ; 


- (instancetype) initWithImage: (UIImage *) anImage 
| 
self - [super initWithImage:anImage]; 
if (self) 
| 
self.userInteractionEnabled - YES; 
UILongPressGestureRecognizer *pressRecognizer - 
[[UILongPressGestureRecognizer alloc] initWithTarget:self 
action:Gselector(pressed:)]; 


[self addGestureRecognizer:pressRecognizer]; 


| 


return self; 


1.16 小结 


UlView 及 其 底层 的 CALayer 为 用 户 能 够 在 屏幕 上 看 到 的 各 种 组 件 提供 了 支持 。 触 摸 功能 使 得 用 户 可 通过 UlTouch 类 及 手势 识别 器 来 直接 操作 视图 。 正 如 本 章 范 例 


程序 所 示 ， 即 便 在 最 为 基本 的 形态 之 下 ， 基 于 触摸 的 界面 也 提供 了 一 套 既 容易 实现 又 很 灵活 的 接口 。 读 者 学 会 了 怎样 在 屏幕 中 移动 视图 ， 也 学 会 了 如 何 对 其 移动 行为 
施加 限制 。 我 们 还 讲 了 怎样 通过 对 触摸 操作 的 检测 来 判断 视图 是 否 应 该 响应 这 些 操 作 。 此 外 ， 大 家 还 知道 了 如 何在 视图 上 面 实现 绘画 功能 ， 以 及 如 何 把 手势 识别 器 与 
视图 相关 联 ， 以 解读 并 响应 手势 。 笔 者 把 本 草 各 个 解决 万 案 所 体现 出 来 的 设计 思路 总结 起 来 ， 读 者 在 继续 学 习 下 一 章 之 前 ， 可 以 先 思 考 一 下 这 些 间 题 。 


. 程序 要 直观 。iOS 设 备 的 屏幕 对 触摸 支持 得 非常 好 。 所 以 ， 你 应 该 考虑 令 用 户 可 以 来 回 拖 昌 屏幕 上 面 的 物件 ， 并 且 使 程序 能 够 随 着 用 户 手指 的 移动 而 画 线 。 这 样 
的 话 ， 程 序 就 显得 更 加 真实 了 ， 而 且 也 把 1iODS 平 台 的 互动 性 质 体现 出 来 了 。 


" 用 户 通常 是 可 以 十 指 并 用 的 。iPad 提 供 了 相当 强大 的 屏幕 操作 能 力 。 所 以 ， 不 要 总 是 设计 只 能 用 一 个 手指 来 操作 的 界面 ， 而 是 应 该 在 屏幕 大 小 容许 的 前 提 下 ， 为 
程序 添加 多 点 触摸 式 的 互动 操作 。 


- 要 扎实 地 掌握 Quattz 图 形 绘制 技术 以 及 Cote Animation API， 这 对 你 很 有 帮助 。 开 发 者 可 以 用 drawRect: 方法 在 UIView 里 面 绘制 出 各 式 各 样 的 内 容 ， 包 括 文本 、 贝 
ZR ZU RB SCR AE. 


: de X Cocoa Touch 所 提供 的 手势 识别 器 不 能 满足 你 的 特定 需求 ， 就 自己 编写 一 个 。 这 不 是 非常 困难 的 事情 ， 你 应 该 尽量 把 代码 写 得 完备 一 些 ， 以 便 将 自 定 义 识别 
器 可 能 历经 的 各 种 状态 都 涵盖 在 内 。 


. 尽 可 能 使 程序 支持 多 点 触摸 ， 如 果 你 想 令 多 位 用 户 能 够 同时 触摸 程序 的 话 ， 就 更 应 该 如 此 了 。 不 要 把 程序 局 限 在 单 人 单 指 触摸 这 种 交互 方式 上 面 ， 有 时 只 需 多 
用 一 点 编程 技巧 ， 就 可 以 使 多 位 用 户 同时 操作 应 用 程序 。 


` 多 多 探索 。 在 应 用 程序 中 实现 直接 操纵 是 有 很 多 方式 的 ， 而 本 章 只 讲 了 有 限 的 几 种 。 请 以 本 章 为 出 发 点 ， 探 索 UITouch 类 的 其 他 各 种 能 力 。 


Ble ”构建 并 使 用 控件 


UIControl 类 是 很 多 iOs 互 动 式 元 件 的 基础 ， 比 如 按钮 、 文 本 框 、 滑 杆 和 开关 等 。 这 些 视 图 对 和 象 都 是 从 同一 个 祖先 类 继承 下 来 的 ， 除 此 以 外 ， 它 们 之 间 还 有 许多 共 
同 点 。 所 有 控件 都 使 用 类 似 的 布局 范式 (layout paradigm) 及 目标 -动作 触 友 器 。 只 学 会 创建 一 种 控件 束 够 了 : 无 论 这 种 控件 多 么 特殊 ， 我 们 都 能 由 此 明日 所 有 控件 
的 工作 原理 。 控 件 的 外 观 及 功能 也 许 各 有 不 同 ， 但 设计 这 些 控件 时 所 依循 的 模式 却 是 相同 的 。 本 章 要 讲解 各 种 控件 及 其 用 途 。 你 将 学 会 以 多 种 方式 来 构建 并 定制 控 
件 。 笔 者 会 给 出 与 控件 有 天 的 各 种 解决 方案 ， 供 你 在 自己 的 程序 里 复 用 ， 这 些 解决 方案 有 的 比较 简单 ， 有 的 比较 复杂 。 


2.1 UlControlzs 


iOS 的 控件 是 程序 库 中 预先 构建 好 的 一 批 对 象 ， 它 们 是 为 了 实现 用 户 交 互 功能 而 设计 的 。 这 些 控件 包括 按钮 、 文 本 框 、 滑 杆 、 开 关 以 及 其 他 一 些 由 苹果 公司 所 提供 
的 对 象 。 控 件 所 扮演 的 角色 惑 是 把 用 户 的 操作 转化 成 回调 。 用 己 通 过 触摸 及 操纵 控件 来 与 应 用 程序 交互 。 


在 控件 类 的 继承 树 里 ，UIControl| 类 是 树 根 。 控 件 类 都 是 UlIView 的 子 类 ， 它 从 UlView 中 继承 了 与 显示 及 布局 有 关 的 全 部 属性 。UIView 的 子 类 添加 了 一 套 响 应 机 
制 ， 该 机 制 可 以 强化 视图 ， 使 其 能 够 具备 交互 性 。 


当 用 户 操 作 控 件 的 界面 时 ， 每 个 控件 都 有 办 法 实现 消息 派 友 。 控 件 使 用 目标 -动作 模式 来 友 送 消息 。 定 义 新 控件 的 时 候 ， 开 友 者 需要 指明 消息 的 接收 方 (也 就是 目 
以 及 所 发 送 的 消息 (也 就 是 动作 ) ， 还 要 指定 友 送 这 些 消息 的 时 机 (也 丈 是 触 友 条 件 ， 比 方 说 ， 当 用 户 在 某 个 控件 范围 内 完成 触摸 操作 时 ， 残 触发 某 消 息 ) 。 


标 


2.1.1 目标 -动作 模式 


目标 -动作 设计 模式 提供 了 一 条 可 以 响应 用 户 交 互 的 底层 途经 。 我 们 基本 上 只 会 在 UIControl| 类 的 子 类 中 磁 到 它 。 经 由 目标 -动作 模式 ， 开 发 者 可 以 在 发 生 了 特定 的 
用 尸 事 件 时 ， 命 令 控 件 给 指定 的 对 象 友 送 消息 。 比 方 说 ， 你 可 以 指明 当 用 户 按 下 按钮 或 调整 滑 杆 时 ， 哪 个 对 象 应 该 接收 相关 的 选择 子 (selector) 。 

开发 者 可 以 随意 提供 选择 子 。 由 于 系统 并 不 在 运行 期 检查 已 ， 所 以 编写 代码 时 需要 小 心 。 假 如 指定 的 选择 子 还 未 声明 ， 那 么 编译 器 会 友 出 警告 ， 有 时 这 能 够 提醒 
开 友 者 注意 选择 子 中 的 拼写 错误 ， 从 而 防止 程序 在 运行 时 崩溃 。 下 面 这 段 代 码 设 置 了 一 对 目标 -动作 组 合 ， 当 用 户 在 按钮 内 松 开 手指 时 ， 程 序 融会 调用 playSound: 这 
个 选择 子 。 假 如 目标 (也 融 是 self) 没有 实现 那个 方法 ,程序 在 运行 的 时 候 束 会 因为 未 定义 的 方法 调用 错误 而 月 演 : 


[button addTarget:self action:@selector (playSound:) 
forControlEvents:UIControlEventTouchUpInside]; 


B-A PRA AAAS Sie ANS. SRRA, ARF MEE AIR ELLMplaySound: 。 开 上 友 者 应 该 目 


coU Ba E ERIS MTR T CASS TATA. CER EB I-II FS BI BRA ITUNES BRERA RASS EAT. Peo: 


if ([someObject respondsToSelector:@selector(playSound: ) ] ) 
[button addTarget:someObject action:@selector (playSound: ) 
forControlEvents:UIControlEventTouchUpInside] ; 


对 于 标准 的 UIControl 来 说， 在 设 定 了 目标 -动作 组 合 之 后 ， 系 统一 般 会 给 选择 子 传递 0 个 、1 个 或 2 个 参数 。 假 如 传递 了 参数 的 话 ， 那 么 参数 就 是 交互 对 象 
(interaction object， 也 就 是 用 户 所 操作 的 按钮 、 滑 杆 或 开关 等 ) 以 及 表示 用 户 输 入 的 UIEvent 对 象 。 系 统 可 以 单单 把 交互 对 象 传递 给 选择 子 ， 也 可 以 把 交互 对 象 和 
相关 事件 一 并 传 过 去 。 在 前 述 范 例 代 码 中 ， 选 择 子 只 接收 一 个 参数 ， 就 是 用 户 正在 点 击 的 UIButton 实 例 。 这 种 自我 引用 式 的 写法 使 得 系统 在 回调 选择 子 的 时 候 ， 可 以 
把 用 户 所 触发 的 对 象 以 参数 的 形式 传 过 去 ， 从 而 令 开 发 者 能 够 编写 出 更 为 通用 的 动作 代码 ， 这 种 代码 知道 究竟 是 哪个 控件 引 帮 了 回调 。 


2.1.2 ”控件 的 种 类 


在 UIControl 家 族 中 ， 系 统 所 提供 的 成 员 有 按钮 、 分 段 选 择 控件 (segmented control) 、 开 关 、 滑 杆 、 页 面 控制 控件 以 及 文本 框 。 这 些 控件 都 可 以 在 Interface 
Builder (简称 |B) 的 Object Library 里 面 找 到 ， 如 图 2-1 所 示 ( 按 下 Command-Control-Option-3 组 合 键 ， 或 者 点 击 View> Utilities» Show Object Library% 
项 ) 。 


2.1.3 ”控件 事件 


控件 主要 响应 三 类 事件 : 基于 触摸 的 事件 、 基 于 值 的 事件 ， 以 及 基于 编辑 的 事件 。 表 2-1 列 出 了 控件 所 能 响应 的 每 种 事件 。 


[) 


Label Button 


图 2-1 Interface Builder 提 供 了 Object Library 中 可 供 使 用 的 控件 。 从 左上 角 开 始 ， 它 们 依次 是 : Æ (label, UlLabel) . #242 (button, UlButton) 、 分 段 选 择 控件 
(segmented control, UlSegmentedControl) 、 文 本 框 (text field，UITextField) 、 滑 杆 (slider, UlSlider) 、 开 关 (switch, UISwitch) 、 活 动 指 示 器 (activity 


indicator, UlActivity-IndicatorView) 、 进 度 指 示 器 (progress indicator, UIProgressView) 、 页 面 控制 控件 (page control, UlPageControl) 以 及 步 进 控件 


(stepper, UlStepper) ， 其 中 ， 活 动 指 示 器 与 进度 指示 器 并 不 是 严格 意义 上 的 控件 
表 2-1 UIControl 所 能 响应 的 各 种 事件 


= zy 
UIControlEventTouchDown fi dt 在 控件 范围 内 所 发 生 的 touch down 事件 
在 控件 范围 内 所 发 生 的 touch up 事件。 这 是 


UIControlEventTouchUpInside SIUE sd icu pa darc epe 
按钮 控件 最 第 使 用 的 事件 类 型 
UIControlEventTouchUpOutside dy 完全 发 生 在 控件 范围 之 外 的 touch up 事件 
这 两 个 事件 分 别 对 应 于 由 控件 范围 外 进入 控 
UIControlEventTouchDragEnter -—" "t T i ; ips BR - h is 
Hifa 件 范 围 内 的 拖 电 操作 以 及 从 控件 范围 内 离开 控 


UIControlEventTouchDragExit 


件 的 拖 电 操作 

在 控件 范围 内 发 生 的 拖 中 事件; 刚刚 离开 控 
件 范 围 的 拖 电 事件 

tapCount 大 于 1 的 重复 touch down 事 件 
(例如 双击 ) 

能 够 取 请 当前 触 措 操作 的 一 种 系统 事件 。 关 
UIControlEventTouchCancel Ar 63 三 触摸 操作 的 各 个 阶段 及 其 生命 期 ， 请 许 见 第 


UIControlEventTouchDragInside 


SUE US 


UIControlEventTouchDragOutside 


UIControlEventTouchDownRepeat fil s 


1 章 

对 应 于 上 述 所 有 触摸 事件 的 掩 码 ， 用 于 捕获 
任意 事件 

由 用 户 所 触发 且 能 够 改变 控件 值 的 事件 ， 
如 移动 滑 杆 控件 上 面 的 滑 块 ， 或 切换 开关 状态 

分 别 表 示 在 pL HI s, Hs] P 
所 发 生 的 和 触摸。 在 范围 内 MR 会 使 文本 框 进 
人 编辑 状态 。 在 范围 外 触摸 ， 则 NM HH 离开 编 
辑 状 态 

修改 UITextrField 内 容 的 编辑 操作 


UIControlEventAllTouchEvents STU Ded 


UIControlEventValueChanged 


UIControlEventEditingDidBegin 
UIControlEventEditingDidEnd 


UIControlEventEditingChanged 


2 X 

文本 框 在 离开 编辑 状态 时 所 发 生 的 事件 ， 该 
事件 未 必 是 由于 用 户 在 文本 框 范围 之 外 点 击 而 
导致 的 

表示 所 有 Editing 事件 的 掩 码 
频 用 程序 专用 的 事件 范围 〈 军 用 ) 
系统 专用 的 事件 范围 〈 罕 用 ) 
EFE. fH. ——— —— 


" Aon BUG ubi. (E. dh 
UIControlEventAllEvents aH. M HI. d 
7 BCE ATE AS 
程序 、 


事 件 


UIControlEventEditingDidEndOnExit 


UIControlEventAllEditingEvents 


UIControlEventApplicationReserved 


UIControlEventSystemReserved 


在 大 多 数 情况 下 ， 事 件 的 用 法 都 可 以 概括 如 下 。 按 钮 使 用 触摸 事件 ， 所 有 与 按钮 相关 的 操作 几乎 都 可 以 通过 UIControlEventTouchUplnside 这 种 事件 类 型 来 处 
理 ， 而 这 也 正 是 1B 创 建 连 接 (connection) 时 所 采用 的 默认 事件 类 型 。 如 果 用 户 调整 了 分 段 选择 控件 、 开 关 、 滑 杆 或 页 面 控制 控件 ， 那 么 就 会 引发 值 事 件 (比方 说 
UlControlEventValueChanged) 。 刷 新 表格 内 容 所 用 的 刷新 控件 也 能 触 友 值 事件 。 当 用 户 切 换 、 滑 动 或 点 击 那些 控件 的 时 候 ， 控 件 的 值 束 会 改变 。UIlTextField 对 象 
会 引 友 编辑 事件 。 当 用 户 在 文本 框 范 围 内 或 范围 外 点 击 以 及 修改 文本 框 中 的 内 容 时 ， 就 会 引 友 这 类 事件 。 


与 10S 的 所 有 GUI 元 件 一 样 ， 你 既 可 以 通过 Xcode 的 1B 界面 来 排 布 控件 ， 也 可 以 用 代码 的 方式 来 实例 化 它们 。 本 草 会 讨论 一 些 与 |B 有 关 的 方案 ， 不 过 我 们 主要 还 是 
关注 基 于 代码 的 解决 方案 。 只 要 学 会 了 用 1B 来 排 布控 件 ， 以 后 无 论 遇 到 什么 控件 ， 都 可 以 用 相同 的 办 法 来 操作 。 我 们 可 以 把 控件 拖 放 到 界面 里 ， 通 过 检查 器 
(inspector) 及 Auto Layout (自动 布局 ) 约束 对 其 进行 定制 ， 并 将 它 与 其 他 |B 对 象 相连 


2.2 按钮 


UIButton 实 例 提 供 了 简单 的 按钮 。 用 户 点 击 按钮 之 后 ， 系 统 会 经 由 目标 -动作 编程 机 制 来 触发 回调 。 开 发 者 可 以 指定 按钮 的 外 观 、 图 样 以 及 它 所 显示 的 文本 。 


iOS 提 供 了 两 种 构建 按钮 的 方式 。 你 可 以 在 预先 设计 好 的 风格 中 选择 一 种 按钮 ， 也 可 以 从 头 开始 构建 自 定义 的 按钮 。 目 前 iOS SDK 所 内 置 的 按钮 风格 非常 有限。 
iOS 7 系统 以 扁平 化 的 极 简 风格 重新 设计 了 整套 UI。 重 新 设计 之 后 ， 最 值得 注意 的 变化 之 一 就 是 它 不 再 使 用 过 时 的 圆 角 矩形 (rounded rectangle) 了 。 这 就 产生 了 一 
种 非常 新 式 的 按钮 ， 按 钮 中 显示 的 是 加 粗 的 纯 文本 ， 这 种 按钮 对 应 于 UIButtonTypeSystem 类 型 。 此 外 ， 其 余 几 种 类 型 的 按钮 在 UI 方面 的 差别 也 变 得 不 是 那么 明显 
T 


预 设 的 几 种 按钮 并 不 是 特别 通用 。 苹 果 公 司 之 所 以 将 其 添加 到 SDK 里 ， 主 要 是 为 了 它 自己 用 着 万 便 ， 而 不 是 为 了 让 开发 者 用 起 来 方便 。 一 般 来 说 ， 假 如 苹果 公司 
目 己 不 党 使 用 某 种 Ul 特性， 那 它 束 不 会 将 其 添加 到 SDK 里 。 不 过 ， 只 要 你 遵照 苹果 公司 的 《Human Interface Guidelines) (人 机 界面 指南 ， 简 称 HIG) 来 设计 界 
面 ， 就 可 以 在 自己 的 程序 里 使 用 那些 控件 。 图 2-2 演 示 了 5 种 按钮 。 


图 2.2 iOS SDK 提 供 了 5 种 风格 的 按钮 ， 它 们 的 界面 可 以 归结 为 3 种 不 同 的 视觉 效果 。 开 发 者 可 通过 IB 来 获取 按钮 ， 也 可 在 程序 中 直接 用 代码 来 添加 。 图 中 的 第 一 个 特 
号 对 应 于 三 种 按钮 : Detail Disclosure. Info Light 与 Info Datk。 另 外 两 种 按钮 是 Contact Add 和 System 按钮 


: Detail Disclosure (详情 展示 按钮 ) 一 一 这 是 个 蓝 色 的 圆圈 ， 中 间 写 有 字母 !， 向 表格 的 单元 格 添加 Detail Disclosure Accessory 时 就 会 看 到 这 种 按钮 。 点 击 表 格 中 


的 Detail Disclosure 按 钮 之 后 ， 程 序 应 该 会 切换 到 另外 一 个 屏幕 ， 以 显示 用 户 所 选单 元 格 的 详细 信息 。 在 iOS 7 系统 之 前 ， 该 按钮 的 样子 是 个 encitcled chevron!!! 


. Info Light (亮色 信息 按钮 ) Info Dark. (上 暗色 信息 按钮 ) 一 一 这 两 种 按钮 的 符号 与 Detail Disclosure £4, 4, 2€ K 65 E] E] V v aA Eis Macintosh £& A 
Dashboard 界 面 的 Widget 里 会 出 现 这 两 种 按钮 ， 点 击 它们 之 后 可 以 看 到 与 该 Widget 有 关 的 信息 ， 或 是 会 跳 转 到 该 Widget 的 设置 界面 。 在 许多 应 用 程序 中 ， 这 些 按钮 用 来 将 
视图 从 一 面 翻 转 到 另 一 面 。 


: Contact Add (添加 联系 人 按钮 ) 一 一 蓝 色 圆圈 正中 有 个 + 号 。 在 Mail 程 序 中 ， 用 户 可 以 通过 该 按钮 为 邮件 信息 添加 新 的 收 信人 。 


.3ystem 一 一 该 按钮 的 背景 是 透明 的 ， 按 钮 之 中 有 个 文本 标签 。System 按 钮 没有 斜面 效果 (bazel) ， 也 没有 背景 ， 不 过 开发 者 可 以 自 定义 它 的 图 像 和 文本 标题 。 
严格 地 说 ，UIButtonTypeCustom 也 算是 个 预制 的 〈precooked) 的 按钮 ， 因 为 它 毕 竟 包 含 了 一 个 UILabel。 但 由 于 它 并 没有 再 提供 外 观 方面 的 其 他 支持 ， 所 以 大 
部 分 开 友 者 都 将 其 看 作 一 种 完全 需要 由 目 己 来 定义 的 按钮 。 


若 想 在 代码 中 使 用 某 种 内 置 的 按钮 ， 那 就 先 为 其 分 配 内 存 ， 然 后 设 定 它 的 框架 或 Auto Layout 约 束 ， 最 后 再 调用 addTarget 方 法 来 添加 目标 即 可 。 开 发 者 无 须 担 心 
如 何 给 按钮 添加 特定 的 图 样 ， 也 不 用 考虑 如 何 创建 按钮 的 总 体 样 狐 ， 这 些 都 由 SDK 来 做 。 比 方 说， 下 面 这 段 代 码 就 能 构建 一 个 简单 的 System 按钮 : 


UIButton *button = [UIButton buttonWithType:UIButtonTypeSysten] ; 

[button setFrame: CGRectMake(0.0f, 0.0f, 80.0f, 30.0f)]; 

[button setCenter: self.view.center]; 

[button setTitle:@"Beep" forState:UIControlStateNormal]; 

[button addTarget:self action:Gselector(playSound) 
forControlEvents:UlControlEventTouchUpInside]; 

[contentView addSubview:button]; 


如 果 要 构建 其 他 类 型 的 标准 按钮 ， 那 就 把 setTitle 那 一 行 代 码 删 掉 。 在 预 设 的 各 类 按钮 忆 中 ， 只 有 System 按钮 才 会 用 到 title。 


在 iOS 7 中 ,包括 UIButton 在 内 的 所 有 UIView 都 文 持 tintColor 属 性 。 该 属性 很 特殊 : 假如 不 做 任何 处 理 ， 那 么 子 视 图 融会 从 其 上 级 视图 中 继承 这 个 tint color, f 


照 这 种 方式 来 看 ， 如 果 设 置 了 应 用 程序 根 视 图 的 tintColor 属 性 ， 那 么 它 就 会 改变 整个 应 用 程序 的 tint colorlc]。 直 接 设 置 子 视图 的 tintColor， 即 可 覆盖 继承 下 来 的 属性 
值 。 


内 置 的 几 种 按钮 默认 的 tint color 都 是 蓝 色 ， 而 开发 者 可 以 通过 tintColor 属 性 把 它 改 成 自己 所 选用 的 颜色 。 对 于 iOS 7 系统 里 面 由 苹果 公司 所 提供 的 视图 及 控件 来 
说 ，tintColor 所 定义 的 颜色 通常 用 于 描绘 用 户 正在 操作 的 控件 ， 或 是 强调 用 户 在 视图 里 所 选 定 的 某 一 部 分 内 容 。 


大 部 分 按钮 都 通过 UIControlEventTouchUplinside 事 件 来 处 理 用 尸 的 操作 ， 如 果 用 户 的 触摸 操作 是 在 按钮 自身 范围 内 结束 的 ， 那 么 束 会 触 友 该 事件 。iOS 的 UI 设 


计 标 准 允 许 用 户 通 过 把 手指 移 到 按钮 范围 之 外 再 松 开 手 所 的 方式 来 取消 对 按钮 的 点 击 。 选 用 UIControlEventTouchUplnside 事 件 来 处 理 用 户 对 按钮 的 操作 是 符合 这 条 
设计 标准 的 。 


如 果 要 使 用 系统 所 提供 的 按钮 ， 那 么 在 设计 按钮 的 用 法 时 ， 融 必须 遵循 芋 果 公司 的 《HIG》。 比 方 说 ， 如 果 添 加 了 一 个 跳 转 到 信息 页 面 的 Detail Disclosure, 882. 
可 能 导致 你 的 应 用 程序 遭 到 App Store 拒 绝 。 你 可 能 认为 自己 的 这 种 用 法 只 不 过 是 适当 地 延伸 了 按钮 的 用 途 ， 但 是 从 《HIG》 的 具体 规则 来 看 ， 这 种 用 法 与 苹果 公司 对 
该 按钮 的 要 求 并 不 相符 ， 所 以 ， 程 序 可 能 通 不 过 评审 。 (程序 能 否 通 过 评审 ， 当 然 是 由 评审 人 员 决 定 的 ， 但 如 果 应 用 程序 因为 违背 《HIG》 而 遭 到 拒绝 ， 那 么 程序 提交 
者 很 难为 此 辩解 。) 为 了 避 开 这 些 潜在 的 问题 ， 开 友 者 应 该 尽量 使 用 System 按 钮 或 自 定义 的 按钮 。 


[1] 可 以 理解 为 “ 带 圆 圈 的 大 于 号 ”或 “ 带 圆 圈 的 V 形 图 案 ”。 译 者 注 
p] 这 是 一 种 泻 染 UI 所 用 的 颜色 ， 用 以 表示 当前 拥有 焦点 的 某 个 控件 ， 或 强调 屏幕 中 值得 注意 的 某 个 部 分 。 可 以 理解 为 关键 色 、 提 示 色 、 高 亮色 、 主 题 色 ， 等 等 。 一 一 
译 者 注 


2.3 Interface Builder 中 的 按钮 


IB 的 Object Library 中 所 列 出 的 按钮 的 默认 类 型 是 System (参见 图 2-1) 。 要 想 使 用 这 种 按钮 ， 可 以 将 其 拖 钨 到 程序 界面 中 。 然 后 ， 你 可 以 在 Attributes 
Inspector 里 修改 按钮 的 类 型 (通过 View> Utility» Show Attributes Inspector 荣 单项 或 Command-Option-4 组 合 键 即 可 调 出 Attributes Inspector) 。Attributes 
Inspector 顶 部 有 个 用 于 修改 按钮 类 型 的 列表 框 。 上 点击 列表 框 之 后 ， 会 弹出 一 份 菜单 ， 开 上 发 者 可 以 从 中 选择 自己 想 要 的 按钮 类 型 。 


如 果 按 钮 中 需要 显示 文本 ， 那 么 可 以 在 Title 文 本 框 里 里 输入 文本 。 开 发 者 可 通过 Image 及 Background 这 两 个 下 拉 列 表 框 来 选择 按钮 的 主 图 像 及 背景 图 像 。 每 个 按 
钮 都 提供 了 四 套 State Config。 这 四 套 Config 所 对 应 的 四 种 状态 分 别 是 : Default (表示 按钮 处 在 通常 状态 ) Highlighted (用 户 正 在 触摸 该 按钮 ) . Selected (对 
于 能 够 切换 状态 的 按钮 来 说 ， 这 表示 按钮 处 在 On 的 状态 ) 以 及 Disabled (表示 用 户 无 法 操作 该 按钮 ) 。 


开发 者 在 Attributes Inspector 的 state Config 区 域内 对 按钮 所 做 的 各 项 变更 都 只 对 应 于 当前 所 选 的 State Config。 比 方 说 ， 开 上 友 者 可 以 为 同一 个 按钮 的 Default 状 
人 态 及 Disable 状 态 分 别 设置 文本 颜色 。 


要 想 预 览 一 下 按钮 在 各 个 状态 下 的 效果 ， 可 以 在 Attributes Inspector 的 Control 区 域 中 调整 那 三 个 Content 复 选 框 。 开 发 者 可 以 经 由 Highlighted、Selected 及 
Enabled 这 三 个 选项 来 设 定 按钮 的 状态 。 预 览 完毕 之 后 ， 记 得 在 编译 前 把 按钮 恢复 到 首次 运行 程序 时 所 应 具备 的 实际 状态 。 


将 按钮 与 动作 相连 


如 果 按 住 Control 键 不 放 ， 在 1B 编 辑 器 界面 里 从 按钮 向 某 个 |B 对 象 (例如 File” s Owner 所 对 应 的 视图 控制 器 ) 拖 岛 ， 那 么 当 松 开 和 鼠标 按钮 时 ，1B 就 会 把 各 种 动作 
列 在 一 份 弹出 式 菜 单 里 面 ， 供 开 友 者 选择 。 〈 另 一 种 操作 方式 是 用 鼠标 右键 拖 抽 。) 这 些 动作 是 根据 目标 对 象 所 能 支持 的 IlBAction 而 列 出 来 的 。 把 按钮 与 动作 相连 之 
后 ,我们 束 为 按钮 的 UIControlEventTouchUplnside 事 件 创 建 了 一 对 目标 -动作 组 合 。 你 也 可 以 按 住 Control 键 不 放 ， 把 按钮 拖 忠 到 自己 的 代码 上 面 ， 这 样 一 
来 ，Xcode 就 会 在 实现 文件 里 面 添 加 一 个 空 的 遂 数 定义 。 


另外 ， 你 还 可 以 按 住 Control 键 并 点 击 Document Outline 中 的 按钮 控件 (也 可 以 用 鼠标 右 击 Document Outline 中 的 按钮 控件 ) ， 然 后 在 弹出 的 菜单 中 找到 
Touch Up Inside 这 一 项 ， 把 旁边 的 空心 圆圈 拖 到 你 想 要 连接 的 东西 上 面 (在 笔者 举 的 这 个 例子 中 ， 指 的 就 是 File” s Owner 对 象 ) 。 此 时 也 会 出 现 刚 才 所 说 的 弹出 式 
菜单 ， 菜 单 里 面 询 出 了 各 种 可 供 使 用 的 动作 。 


Qi 在 IB 里 面 ， 你 会 遇 到 看 着 很 像 视 图 而 行为 也 很 像 视 图 的 按钮 ， 但 实际 上 ， 那 些 按钮 并 不 是 视图 。 工 具 栏 或 导航 栏 上 会 出 现 一 些 那样 的 按 
钮 ，UIBarButtonItem 用 于 保存 那 种 按钮 的 属性 ， 但 UIBatButtonItem 本 身 却 不 是 按钮 。 工 具 栏 与 导航 栏 会 在 内 部 构建 一 种 特殊 的 按钮 来 表示 这 种 逻辑 实体 。 


24 ”解决 万 案 : 构建 按钮 


如 果 要 使 用 UIlButtonTypeCustom 风 格 的 按钮 ， 开 发 者 应 该 自己 来 提供 按钮 所 需 的 全 部 图 片 。 具 体 应 该 提供 几 张 图 像 要 根据 按钮 的 工作 方式 来 定 。 对 于 那 种 入 单 
的 推 压 按钮 (pushbutton) 来 说 ， 只 需要 提供 一 张 背 景 图 即 可 ， 另 外 ， 还 需要 在 用 尸 按 下 按钮 的 时 候 改 变 其 文本 颜色 ， 以 实现 高 亮 效 果 。 


对 于 切换 式 按钮 (toggle-style) 来 说 ， 可 能 需要 准备 四 张 图 : off 状 态 下 的 普通 图 样 、off 状 态 下 的 高 亮 图 样 (所 谓 高 亮 ， 束 是 指 用 尸 按 下 按钮 时 的 样子 ) 、on 状 
态 下 的 普通 图 样 以 及 on 状态 下 的 高 党 图 样 。 与 操作 该 按钮 有 天 的 细节 需要 由 开 友 者 选 定 并 设计 出 来 ， 我 们 还 要 记得 给 程序 里 面 添 加 相 天 的 状态 (比如 像 解决 方案 2-1 那 
样 ， 用 名 为 isOn 的 布尔 型 实例 变量 来 表示 按钮 状态 ) ， 这 样 束 可 以 把 普通 的 推 压 按钮 扩展 为 切换 式 按钮 了 。 假 如 你 只 提供 了 一 张 普 通 的 图 像 ， 而 没有 指明 按钮 在 高 亮 


及 荣 用 状态 时 所 用 的 图 像 ， 那 么 IOs 残 会 自动 生成 那些 图 像 。 


解决 方案 2-1 构 建 了 一 种 可 在 on 和 off 之 间 来 回 切 换 的 按钮 ， 并 演示 了 构建 自 定义 按钮 时 所 需 处 理 的 基本 细节 。 用 尸 点 击 按钮 时 ， 其 着 色 会 从 绿色 变 为 红色 ,或 从 
红色 变 为 绿色 (红色 表示 off， 绿 色 表 示 on) 。 只 要 用 户 不 是 色盲 ， 立 刻 就 能 够 根据 按钮 颜色 辨识 出 当前 的 状态 。 而 按钮 中 间 所 显示 的 文本 也 与 当前 状态 相对 应 ， 这 就 
进一步 强化 了 按钮 状态 的 可 辨识 程度 。 图 2-3 左 侧 就 是 本 条 解决 方案 所 要 创建 的 那 种 按钮 。 


Carrier = 8:41 PM Carrier = 8:42 PM 


Button: On Button: On 


图 2-3 ”通过 拉 伸 UIImage 来 调整 按钮 图 样 ， 使 之 能 够 适用 于 任意 


Ullimage 类 的 resizablelmageWithCaplnsets 方 法 可 以 缩放 图 像 ， 而 这 正 是 本 条 解决 方案 在 创建 按钮 时 所 执行 的 关键 操作 。 借 助 图 像 缩 放 功 能 ， 我 们 把 圆 形 图 样 
拉 伸 为 局 的 惨 形 图 样 ， 从 而 创建 出 任意 宽度 的 按钮 来 。 开 发 者 需要 指定 cap 值 (该 值 用 于 摘 述 图 像 里 面 不 应 该 拉 伸 的 部 分 ) 。 在 本 例 中 ， 左 右 两 侧 的 cap 都 是 110 像 
素 。 假 如 我 们 把 按钮 宽度 从 本 例 中 的 300 像 素 变 为 220 像 素 ， 那 么 按钮 中 间 拉 伸 的 部 分 束 不 见 了 ， 它 会 变 成 图 2-3 右 侧 那 个 样子 。 

开 友 者 可 以 根据 状态 来 设 定 按钮 的 图 像 和 背景 图 。 图 像 表 示 按 钮 的 实际 内 容 ， 而 背景 图 则 好 比 一 块 幕布 ， 图 像 及 文本 都 会 出 现在 它 的 前 方 。 解 决 方案 2-1 设 置 了 近 
钮 的 背景 图 ， 使 得 按钮 内 的 标题 (title) [可 以 浮动 在 开发 者 所 提供 的 图 样 上 方 。 


Qi 通过 调整 CALayet 对 象 的 相关 属性 ， 我 们 可 以 修改 视图 及 按钮 的 四 个 角 所 具备 的 圆滑 程度 。 把 Quattz Core 框 架 添 加 到 项 目 中 ， 然 后 就 可 以 用 代码 来 访问 视 
图 的 CALayet 对 象 并 设置 其 cornerRadius 属 性 。 设 置 好 这 个 属性 之 后 ， 我 们 把 视图 的 clipsToBounds 属 性 设 为 YES， 以 便 实现 革 果 公司 风格 的 圆 角 效果 。 


解决 方案 2-1 构建 一 种 可 在 On 和 Off 状 态 之 间 切 换 的 UIButton 


Hdefine CAPWIDTH 110 JOS 

#define INSETS (UIEdgeInsets)(0.0f, CAPWIDTH, 0.0f, CAPWIDTH} 

#define BASEGREEN [[UIImage imageNamed:@"green-out.png"] ^ 
resizableImageWithCapInsets:INSETS] 

#define PUSHGREEN [[UIImage imageNamed:G"green-in.png"] ^ 
resizablelmageWithCapInsets:INSETS] 


Hdefine BASERED [[UIImage imageNamed:@"red-out.png"] \ 
resizableImageWithCapInsets: INSETS] 
#define PUSHRED [[UIImage imageNamed:@"red-in.png"] \ 


resizableImageWithCapInsets: INSETS] 


- (void) toggleButton: (UIButton *)aButton 
{ 
self.isOn = !self.isOn; 
if (self.isOn) 
{ 
[self setBackgroundImage : BASEGREEN 
forState:UIControlStateNormal] ; 
[self setBackgroundImage : PUSHGREEN 
forState:UIControlStateHighlighted] ; 
[Self setTitle:@"On" forState:UIControlStateNormal] ; 
[self setTitle:e"On" forState:UIControlStateHighlighted] ; 


} 


else 
{ 
[self setBackgroundImage : BASERED 
forState:UIControlStateNormal]; 
[self setBackgroundImage:PUSHRED 
forState:UIControlStateHighlighted] ; 
[self setTitle:@"Off" forState:UIControlStateNormal] ; 
[self setTitle:@"Off" forState:UIControlStateHighlighted] ; 


+ (instancetype) button 
PushButton *button = 
[PushButton buttonWithType:UIButtonTypeCustom]; 


// Set up the button alignment properties 

button.contentVerticalAlignment - 
UIControlContentVerticalAlignmentCenter; 

button.contentHorizontalAlignment - 
UIControlContentHorizontalAlignmentCenter; 


// Set the font and color 
[button setTitleColor: 

[UIColor whiteColor] forState:UIControlStateNormal]; 
[button setTitleColor: 


[UIColor lightGrayColor] forState:UIControlStateHighlighted]; 
button.titleLabel.font - [UIFont boldSystemFontOfSize:24.0f]; 


// Set up the art 

[button setBackgroundImage:BASEGREEN 
forState:UIControlStateNormall; 

[button setBackgroundImage : PUSHGREEN 
forState:UIControlStateHighlighted] ; 

[button setTitle:@"On" forState:UIControlStateNormal]|; 

[button setTitle:e"On" forState:UIControlStateHighlighted] ; 

button.isOn = YES; 


// Add action. Client can add one too. 
[button addTarget:button action:Gselector(toggleButton:) 
forControlEvents: UIControlEventTouchUpInside] ; 


return button; 


[1] 有 具体 是 指 titleLabel 属 性 。title 或 text title 这 种 说 法 可 以 理解 成 按钮 内 的 文本 。 


译 者 注 


2.4.1 多 行 按钮 文本 


通过 按钮 的 titleLabel 属 性 ， 可 以 修改 其 标题 ， 例 如 ， 可 以 改变 字体 及 换行 模式 。 我 们 故意 把 字 设 置 得 非常 大 ， 使 文本 差不多 达到 足以 换行 的 程度 ， 然 后 把 换行 模 
式 设 为 在 词 的 边界 处 换行 (word wrap) ， 并 把 对 齐 万 式 设 为 居中 : 


button.titleLabel.font = [UIFont boldSystemFontOfSize:36.0f]; 

[button setTitle:@"Lorem Ipsum Dolor Sit" forState: 
UIControlStateNormal]; 

button.titleLabel.textAlignment - UITextAlignmentCenter; 

button.titleLabel.lineBreakMode = UILineBreakModeWordWrap; 


在 默认 情况 下 ， 按 钮 内 的 标签 会 从 按钮 的 一 端 延 伸 至 另 一 端 。 这 也 就 是 说 ， 文 本 可 能 会 超出 预期 的 宽度 ， 甚 至 可 能 会 越过 按钮 图 片 的 边界 。 为 解决 此 问题 ， 可 以 
在 文本 中 插入 换行 符 (EMEN) ,这样 就 能 够 在 word wrap 模 式 下 实现 强制 回 车 了 。 由 此 ， 我 们 可 以 分 别 控制 按钮 标题 每 一 行 所 包含 的 字符 数 。 


2.4.2 “为 按钮 添加 动画 元 件 

制作 按钮 的 时 候 ， 可 以 把 一 些 图 形 放 在 按钮 的 前 面 或 后 面 。 我 们 采用 标准 的 UIView 体 系 来 做 这 件 事 ， 并 在 相关 的 视图 中 把 setUserlnteractionEnabled 设 为 NO， 
禁止 用 户 去 操作 那些 可 能 会 干扰 该 按钮 的 视图 。 我 们 还 要 把 Image 视 图 里 的 内 容 露 出 来 ， 使 用 户 能 够 看 到 开发 者 为 按钮 所 添加 的 动画 元 件 。 

解决 方案 2-1 使 用 一 张 半 透 明 的 范例 图 来 试验 这 种 效果 。 这 段 范 例 代码 会 添加 一 组 蝴蝶 图 案 ， 开 发 者 可 以 把 它 放 在 按钮 后 面 ， 并 播放 其 动画 效果 。 


动画 元 件 对 于 展示 状态 来 说 特别 有 用 ， 尤 其 适合 展示 正在 进行 中 的 操作 。 它 们 可 以 告诉 用 户 按 钮 为 什么 无 法 响应 ， 也 可 以 在 用 户 按 下 按钮 的 时 候 产 生 另 外 一 种 反 
应 。 比 万 说 ,游戏 里 面 可 能 会 出 现 超 强 按钮 (turbo-enhanced button) ， 玩 家 按 下 它 的 时 候 会 获得 额外 的 力量 。 对 于 这 种 按钮 来 说 ， 开 发 者 可 以 通过 动画 效果 使 玩 
家 意识 到 按钮 的 功能 已 经 友 生 了 变化 。 


把 图 案 及 文本 同 按钮 的 实现 代码 分 开 ， 这 种 做 法 在 开发 程序 的 时 候 还 有 其 他 用 途 。 我 们 可 以 先 设计 一 个 空白 的 按钮 ， 然 后 把 这 些 乐 西 添加 到 该 按钮 的 后 面 或 前 
面 ， 这 样 一 来 ， 开 友 者 融 能 在 无 须 重 新 设计 整个 按钮 的 前 提 下 ， 分 别 控制 其 图 案 及 文本 了 。 


2.4.3 ”为 按钮 添加 额外 状态 


解决 方案 2-1 创 建 的 按钮 具备 两 种 状态 ， 分 别 能 够 呈现 视觉 上 的 开 、 关 效果 。 有 时 候 我 们 需要 给 按钮 再 添加 一 些 容易 辨识 的 状态 ， 最 常见 的 场合 是 游戏 。 许 多 游戏 
开发 者 需要 实现 具备 四 种 状态 的 按钮 ， 分 别 用 来 表示 尚未 开放 的 关卡 (locked level) 、 已 开放 但 还 未 玩 过 的 关卡 (unlocked-but-not-played) 、 已 开放 而 且 已 玩 过 
部 分 内 容 的 关卡 (unlocked-and-partially-played) 以 及 已 开放 而 且 已 完成 的 关卡 (unlocked-and-mastered) 。 


解决 方案 2-1 使 用 简单 的 布尔 值 (也 融 是 jsOn 这 个 实例 变量 ) 来 保存 on 和 off 这 两 种 状态 。 然 后 在 toggleButton: 方法 中 根据 当前 状态 来 选择 按钮 图 案 。 可 以 改编 
这 上段 范例 代码 ， 用 整数 来 保存 状态 ， 并 通过 switch 语 句 选择 相关 状态 下 的 图 案 ， 这 样 束 能 够 令 按 钮 支持 更 多 的 图 案 和 状态 了 。 


获取 解决 方案 代码 


访问 https://github.com/erica/iOS-7-Cookbook 网 页 ， 并 打开 C02Controls 文 件 夹 ， 即 可 找到 与 本 章 中 的 解决 方案 相对 应 的 完整 范例 项 目 。 


25 解决 方案 : 使 按钮 以 动画 效果 来 响应 用 户 


除了 frame 属 性 与 目标 -动作 机 制 之 外 ，UIControl 实 例 里 面 还 有 许多 东西 。 所 有 的 控件 都 继承 自 UIView 类 。 这 束 意 味 着 开发 者 在 制作 控件 时 ， 可 以 像 对 待 标准 的 
视图 那样 ， 在 它 上 面 调 用 animateWithDuration， 并 把 一 段 代 码 放 在 块 里 面 ， 以 实现 动画 效果 。 解 决 方案 2-2 所 构建 的 开关 式 按 钮 能 够 在 用 户 点 击 它 的 时 候 变 大 ， 并 在 
用 户 松 开 手 指 的 时 候 恢 复原 状 。 


解决 方案 2-2 ”把 UIView 动 画 代码 块 添加 到 控件 中 
- (void) zoomButton: (id) sender 
// Slightly enlarge the button 
[UIView animateWithDuration:0.2f animations: ~{ 
button.transform = 
CGAffineTransformMakeScale(1.1f, 1.1£);}]; 


- (void) relaxButton: (id) sender 


// Return the button to its normal size 


[UIView animateWithDuration:0.2f animations:^( 
button.transform - CGAffineTransformIdentity;]]; 


- (void)toggleButton: (UIButton *)button 
{ 
self.isOn = !self.isOn; 
if (self.isOn) 
| 
[button setTitle:@"On" forState:UIControlStateNormal]; 
[button setTitle:@"On" forState:UIControlStateHighlighted] ; 
[button setBackgroundImage : BASEGREEN 
forState:UIControlStateNormal]; 
[button setBackgroundImage : PUSHGREEN 
forState:UIControlStateHighlighted] ; 


else 


[button setTitle:@"Off" forState:UIControlStateNormal]; 

[button setTitle:e"Off" 
forState:UIControlStateHighlighted] ; 

[button setBackgroundImage : BASERED 
forState:UIControlStateNormal] ; 

[button setBackgroundImage :PUSHRED 
forState:UIControlStateHighlighted] ; 


| 


[self relaxButton:button]; 


+ (instancetype)button 


{ 


PushButton *button = 
[PushButton buttonWithType:UIButtonTypeCustom] ; 


// Add actions 
[button addTarget:button action:@selector (toggleButton: ) 
forControlEvents: UIControlEventTouchUpInside] ; 
[button addTarget:button action:G?selector(zoomButton:) 
forControlEvents: UIControlEventTouchDown | 
UIControlEventTouchDragInside | 
UIControlEventTouchDragEnter]; 
[button addTarget:button action:Gselector(relaxButton:) 
forControlEvents: UIControlEventTouchDragExit | 
UIControlEventTouchCancel | 
UIControlEventTouchDragOutside]; 


return button; 


本 条 解决 方案 创建 了 一 种 活泼 的 交互 效果 ， 使 用 户 能 够 更 加 关注 其 所 操作 的 控件 。 


Qi 请 注意 ， 开 发 者 可 以 在 按钮 上 调用 setAttributedTitleForState: 方法 来 设 定 NSAtttibutedStting 值 ， 通 过 这 项 巧妙 的 功能 ， 我 们 可 以 给 按钮 再 添加 一 些 效果 。 
本 章 稍 后 的 解决 方案 2-4 通 过 类 似 的 办 法 ， 改 变 分 段 选 择 控 件 〈segmented control) 上 面 的 文本 颜色 。 


2.6 解决 方案 : 为 月 杆 控件 添加 目 定义 的 背 块 


Ulslider 实 例 对 应 于 滑 杆 (slider) 控件 ， 用 尸 可 以 通过 滑 块 在 该 控件 的 左 极 值 和 右 极 值 之 间 滑 动 ， 以 选 定 某 个 数值 。Music 程 序 里 残 有 这 个 控件 ， 用 尸 可 以 用 
UlSlider 类 控制 音量 大 小 。 


在 默认 情况 下 ，Slider 控 件 的 最 小 值 是 0.0， 最 大 值 是 1.0， 开 发 者 可 以 在 1B 的 Attributes Inspector 里 面 调整 这 两 个 值 ， 也 可 以 通过 minimumValue 及 


maximumValue 属 性 来 设置 它们 。 为 了 美化 该 控件 的 两 个 端点 ， 我 们 可 通过 minimumValuelmage 及 maximumValuelmage 属 性 来 设 定 一 对 图 像 ， 以 便 更 直观 地 表 
示 出 控件 的 最 小 值 和 最 大 值 。 比 方 说 ， 对 于 调整 温度 的 Slider 控 件 来 说 ， 你 可 以 在 一 端 放 上 雪人 图 案 ， 另 一 端 放 上 一 杯 热 茶 。 


通过 minimumTrackTintColor、maximumTrackTintColor 及 thumbTintColor 这 三 个 属性 ， 开 发 者 可 以 设置 位 于 滑 块 之 前 和 滑 块 之 后 的 轨道 颜色 ， 也 可 以 设置 滑 
块 本 身 的 颜色 。 在 iOS 7 系统 中 ， 如 果 把 minimumTrack-TintColor 设 为 nil， 那 么 位 于 滑 块 之 前 的 轨道 的 色彩 颜色 (tint color) 就 和 上 级 视图 的 相同 。 其 他 两 个 属性 若 
是 nil， 系 统 则 将 其 视 为 相关 的 默认 颜色 。 


用 户 拖 蝶 滑 块 时 ，Slider 控 件 是 否 会 持续 不 断 地 发 送 数 值 更 新 通知 要 通过 continuous 属 性 来 控制 。 该 属性 的 默认 值 是 YES， 如 果 将 其 设 为 NO， 那 么 Slider 控 件 只 
会 在 用 户 松 开 滑 块 时 友 送 一 次 动作 事件 。 


2.6.1 定制 Ulslider 控 件 


除了 可 以 设置 表示 最 小 值 与 最 大 值 的 图 像 之 外 ， 开 发 者 也 可 以 直接 更 新 U1Slider 控 件 的 滑 块 组 件 。setThumblmage: forState: 方法 可 以 把 滑 块 设 定 成 自己 想 要 


的 图 像 。 解 决 方案 2-3 采 用 这 种 方式 动态 地 构建 滑 块 图 像 ， 其 效果 如 图 2-4 所 示 。 用 户 在 用 手指 调整 滑 块 的 时 候 ， 上 方 会 出 现 气 泡 状 的 提示 信息 ， 而 这 个 气泡 也 是 滑 块 
的 一 部 分 。 该 气泡 能 够 以 文本 和 图 像 两 种 方式 把 控件 数值 实时 反馈 给 用 户 : 气泡 内 写 有 控件 当前 的 值 ， 而 气泡 颜色 也 会 随 着 用 户 的 拖 电 逐渐 由 黑 变 白 。 
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屏幕 上 方 的 图 标 会 按 比 例 缩放 ， 笔 者 之 所 以 又 添加 了 这 么 一 种 视觉 反馈 方式 ， 是 想 要 在 范例 代码 里 演示 目标 -动作 机 制 的 用 法 ) 


Qs 修改 UIView 所 显示 的 内 容 时 ，iOS 会 为 视图 的 CALayet 创 建 一 张 位 图 。 无 论 是 在 定制 视图 上 面 操作 还 是 在 生成 的 位 图 上 面 操 作 ， 其 效率 都 差不多 。 
我 们 可 以 依照 任意 类 型 的 数据 来 构建 这 种 动态 反馈 效果 。 除 了 根据 用 户 手 指 的 移动 来 读 取 3lider 控 件 值 之 外 ， 还 有 很 多 办 法 ， 比 方 说 ， 可 以 从 设备 的 感应 器 里 面 抓 


取 数 据 ， 也 可 以 去 获取 Internet 上 面 的 数据 。 无 论 采 用 哪 种 办 法 ， 动 态 更 新 都 必然 要 涉及 大 量 的 图 形 运算 ， 不 过 ， 其 运算 量 也 没有 大 到 令 人 担忧 的 程度 。Core 


Graphics API 的 执行 速度 很 快 ， 而 且 生 成 渔 块 那么 大 的 图 像 所 需 的 内 存量 也 很 小 。 


这 份 解 决 方案 给 Slider 控 件 设置 了 两 种 滑 块 图 像 。 只 有 当 用 户 正在 使 用 Slider 的 时 人 息 ， 也 就 是 控件 处 于 UIControlStateHighlighted 状 态 时 ， 其 上 方才 会 显示 出 气 
泡 。 在 普通 状态 下 ， 也 就 是 UIControlSstateNormal 状 态 下 ， 用 户 只 会 看 到 表示 滑 块 的 那个 小 和 矩形。 点 击 滑 块 之 后 ， 就 能 知道 Slider 控 件 当前 的 值 了 。 这 种 与 上 下 文 相 
关 的 反馈 气泡 与 标准 iOS 键 盘 的 字母 高 亮 效 果 中 相似 。 


为 了 适应 绘制 效果 上 的 变化 ， 我 们 需要 在 每 个 手势 开始 和 结束 的 时 候 修 改 Slider 控 件 的 框架 (frame) 。 用 尸 开始 触摸 控件 时 (taU AC E 
UIControlEventTouchDown 事 件 时 ) ， 框 架 会 变 高 60 个 像素 。 有 了 多 出 来 的 空间 之 后 ， 用 户 束 可 以 在 拖 动 控件 的 过 程 中 看 到 滑 块 上 方 的 气泡 了 。 


用 户 松 开 手 指 时 (也 就 是 发 生 UIControlEventTouchUplnside 或 UIControlEvent-TouchUpOutside 事 件 时 ) ， 滑 杆 的 框架 会 恢复 到 它 原来 的 大 小 。 这 样 就 能 腾 
出 空间 ， 以 显示 其 他 对 象 ， 除 非 用 户 再 次 直接 触摸 这 个 滑 杆 ， 否 则 它 不 会 激活 。 


[1] 用 户 点 击 键盘 上 的 某 个 字母 时 ， 该 字母 会 以 放大 的 形态 显示 在 按键 上 方 。 译 者 


2.6.2 ”添加 优化 代码 


为 了 尽 可 能 降低 iOs 设 备 的 总 体 运 算 量 ， 我 们 在 解决 方案 2-3 里 保 仓 了 slider 控 件 前 一 次 的 值 。 如 果 滑 杆 控件 值 的 变化 量 达 到 0.1 (也 融 是 达到 取 值 沁 围 的 10%) , 
那么 我 们 融 用 一 张 新 的 定制 图 像 来 更 新 滑 块 的 样 狐 。 假 如 你 想 实 现 完全 实时 的 更 新 效果 ， 可 以 把 这 项 检测 从 代码 中 删 把。 在 第 一 代 iPod touch 设 备 上 ， 滑 块 图 像 的 更 
新 操作 执行 得 就 已 经 相当 快 了 ， 而 在 近期 推出 的 iPhone 与 iPad 上 ， 则 完全 没有 性 能 问题 。 


解决 方案 2-3 ”为 滑 杆 控件 制作 动态 图 样 


/* Thumb.m */ 
// Create a thumb image using a grayscale/numeric level 
UIImage *thumbWithLevel(float aLevel) 


| 


float INSET AMT - 1.5f; 


CGRect baseRect = CGRectMake(0.0f, 0.0f, 40.0f, 100.0£); 
CGRect thumbRect = CGRectMake(0.0£, 40.0f, 40.0f, 20.0f); 


UIGraphicsBeginImageContext (baseRect.size); 
CGContextRef context - UIGraphicsGetCurrentContext(); 


// Create a filled rect for the thumb 
[[UIColor darkGrayColor] setFill]; 
CGContextAddRect (context, 

CGRectInset (thumbRect, INSET AMT, INSET AMT)); 
CGContextFillPath(context); 


// Outline the thumb 
[[UICOlor whiteColor] setStroke] ; 
CGContextSetLineWidth(context, 2.0f); 
CGContextAddRect (context, 

CGRectInset(thumbRect, 2.0f * INSET AMT, 2.0f * INSET AMT)); 
CGContextStrokePath(context); 
// Create a filled ellipse for the indicator 
CGRect ellipseRect = CGRectMake(0.0f, 0.0f, 40.0f, 40.0f); 
[[UIColor colorWithWhite:aLevel alpha:1.0f] setFill]; 
CGContextAddEllipseInRect (context, ellipseRect); 
CGContextFillPath(context) ; 


// Label with a number 

NSString *numString = 
[NSString stringWithFormat:@"%0.1f", aLevel]; 

UIColor *textColor = (aLevel > 0.5£) ? 

[UIColor blackColor] : [UIColor whiteColor] ; 

UIFont *font = [UIFont fontWithName:@"Georgia" size:20.0f]; 

NSMutableParagraphStyle *style = 
[[NSMutableParagraphStyle alloc] init]; 

style.lineBreakMode = NSLineBreakByCharWrapping; 

Style.alignment = NSTextAlignmentCenter; 

NSDictionary *attr - G(NSFontAttributeName:font, 
NSParagraphStyleAttributeName:style, 
NSForegroundColorAttributeName:textColor); 

[numString drawInRect:CGRectInset (ellipseRect, 0.0f, 6.0f) 
withAttributes:attr]; 


// Outline the indicator circle 

[[UIColor grayColor] setStroke]; 

CGContextSetLineWidth(context, 3.0f); 

CGContextAddEllipseInRect (context, 
CGRectInset(ellipseRect, 2.0f, 2.0f)); 

CGContextStrokePath (context) ; 


// Build and return the image 
UIImage *theImage = UIGraphicsGetImageFromCurrentImageContext () ; 
UIGraphicsEndImageContext () ; 


return thelmage; 


// Return a base thumb image without the bubble 

UIImage *simpleThumb() 

{ 
float INSET AMT 1.5Ef; 
CGRect baseRect = CGRectMake(0.0f, 0.0f, 40.0f, 100.0f); 
CGRect thumbRect = CGRectMake(0.0f, 40.0f, 40.0f, 20.0£); 


UIGraphicsBeginImageContext (baseRect.size); 
CGContextRef context = UIGraphicsGetCurrentContext () ; 


// Create a filled rect for the thumb 
[[UIColor darkGrayColor] setFill]; 
CGContextAddRect (context, 

CGRect Inset (thumbRect, INSET AMT, INSET AMT)); 
CGContextFillPath(context) ; 


// Outline the thumb 
[[UICOlor whiteColor] setStroke]; 
CGContextSetLineWidth(context, 2.0f); 
CGContextAddRect (context, 
CGRectInset(thumbRect, 2.0f * INSET AMT, 2.0f * INSET AMT)); 
CGContextStrokePath(context); 


// Retrieve the thumb 

UIImage *theImage = UIGraphicsGetImageFromCurrentImageContext () ; 
UIGraphicsEndImageContext () ; 

return theImage; 


} 


/* CustomSlider.m */ 
// Update the thumb images as needed 
- (void) updateThumb 


{ 


// Only update the thumb when registering significant changes 
if ((self.value < 0.98) && 
(ABS (self.value - previousValue) < 0.1f)) return; 


// create a new custom thumb image for the highlighted state 

UIImage *customImg = thumbWithLevel (self.value) ; 

[self setThumbImage:customImg 
forState:UIControlStateHighlighted] ; 

previousValue = self.value; 


| 


// Expand the slider to accommodate the bigger thumb 
- (void)startDrag: (UISlider *)aSlider 


{ 


self.frame = CGRectInset(self.frame, 0.0f, -30.0f); 


// At release, shrink the frame back to normal 
- (void)endDrag: (UISlider *)aSlider 


| 


self.frame = CGRectInset(self.frame, 0.0f, 30.0f£f); 


- (instancetype) initWithFrame: (CGRect)aFrame 


| 


self - [super initWithFrame:aFrame]; 
if (self) 


| 


// Initialize slider settings 
previousValue - CGFLOAT MIN; 
self.value = 0.0f; 


[self setThumbImage:simpleThumb() 
forState:UIControlStateNormal]; 


// Create the callbacks for touch, move, and release 

[self addTarget:self action:@selector(startDrag: ) 
forControlEvents:UIControlEventTouchDown] ; 

[self addTarget:self action:@selector (updateThumb) 
forControlEvents:UIControlEventValueChanged] ; 

[self addTarget:self action: @selector (endDrag: ) 
forControlEvents:UIControlEventTouchUpInside | 

UIControlEventTouchUpOutside]; 


| 


return self; 


+ (instancetype) slider 


| 


CustomSlider *slider - [[CustomSlider alloc] 
initWithFrame: (CGRect) {.size=CGSizeMake(200.0f, 40.0£)]]; 


return slider; 


当 滑 块 接 近 右 端 ， 也 就 是 控件 值 接 近 1.0 时 ， 可 能 会 出 现 前 一 次 的 值 大 于 0.9， 而 本 次 变更 量 又 不 足 0.1 的 情况 。 为 了 应 对 这 种 情况 ， 笔 者 把 0.98 这 个 “ 硬 编码 ” 放 
在 解决 方案 里 面 ， 授 使 清 杆 在 值 大 于 0.98 的 时 候 无 条 件 地 更 新 滑 块 图 像 。 


2.7 解决 万 案 : 创建 可 以 连续 点 击 两 次 的 分 段 选择 控件 


UlsegmentedControl 类 提供 了 一 套 含 有 多 个 按钮 的 界面 ， 用 户 可 从 这 一 组 按钮 里 面 选择 一 个 。 该 控件 有 两 种 用 法 (这 里 指 的 不 是 用 于 改变 控件 UI 样 够 的 
UlSegmentedControlStyle, iOS 7 已 经 将 UlSegmentedControlStyle 弃 用 了 ) 。 第 一 种 用 法 和 一 组 普通 的 单 选 按钮 类 似 ， 用 户 选 定 了 一 个 按钮 之 后 ， 它 就 一 直 处 于 
受 选 状态 。 此 时 用 户 可 以 点 击 控件 上 的 其 他 按钮 ， 也 可 以 点 击 目前 已 经 选 定 的 按钮 ， 但 是 ， 重 复 点 击 已 经 选择 的 按钮 并 不 产生 新 的 事件 。 如 果 把 名 为 momentary 的 布 
尔 属 性 设 为 YES9， 那 么 控件 融会 切换 到 另外 一 种 用 法 ， 此 时 用 户 可 以 在 每 个 按钮 上 面 随意 点 击 ， 但 无 论点 击 多 少 次 ， 控 件 都 不 会 用 状态 来 记录 当前 受 选 的 是 哪个 按钮 。 
也 就 是 说 ， 控 件 不 会 用 高 亮 效 果 来 描绘 用 户 最 新 选 定 的 按钮 。 


解决 方案 2-4 巴 这 两 种 用 法 结合 起 来 ， 使 用 户 既 能 看 到 当前 选中 的 这 一 项 ， 又 能 继续 点 击 已 经 选 定 的 按钮 。 这 种 运作 方式 与 分 段 选 择 控件 的 常见 用 法 不 同 。 不 过 有 
些 情 况 下 ,我们 需要 在 用 户 重 复 点 击 已 经 选中 的 按钮 时 产生 一 种 新 的 效果 (这 类 似 于 刚才 提 到 的 第 二 种 用 法 ) ， 同 时， 又 希望 控件 能 够 把 最 新 选 定 的 按钮 标识 出 来 
(这 类 似 于 刚才 提 到 的 第 一 种 用 法 ) 。 


用 常规 方式 是 无 法 实现 这 个 需求 的 。 不 能 通过 添加 一 对 目标 -动作 组 合 来 检测 UIControlEventTouchUplnside 事 件 。 因 为 UlISegmentedControl 实 例 只 会 产生 一 种 
控件 事件 ， 即 UIControlEventValueChanged 事 件 。 (读者 可 以 自己 试 着 添加 针对 触摸 事件 的 目标 -动作 组 合 ， 看 看 是 不 是 这 样 。 ) 


该 需求 可 以 通过 子 类 来 实现 。 从 UlSegmentedControl 继 承 新 的 类 ， 并 在 该 类 上 面 咱 应 用 户 对 同一 个 按钮 的 第 二 次 点 击 ， 这 相对 来 说 比较 简单 。 解 决 方案 2-4 束 定 
义 了 这 样 的 子 类 。 这 个 目 定 义 的 UlISegmentedControl 控 件 会 从 UIControl 中 继承 一 套 内 置 的 触摸 事件 处 理 器 ， 此 外 ， 它 自己 还 有 一 套 触 摸 事 件 处 理 代 码 ， 当 检测 到 触 
摸 事 件 时 ， 这 两 套 处 理 机 制 将 会 各 自 独 立 运 作 。 


UlsegmentedControl 控 件 上 的 开关 按钮 都 不 会 受 影响 ， 它 们 依然 能 够 随 着 用 户 的 点 击 而 来 回 切换 。 但 与 其 父 类 不 同 的 是 ， 如 果 用 户 在 已 经 按 下 的 按钮 上 面 继续 
点 击 ， 那 么 子 类 会 做 一 些 事情 。 在 本 例 中 ， 子 类 所 做 的 事情 是 在 本 对 象 的 tapDelegate 上 触发 performSegmentAction 方 法 。 


在 使 用 UlSegmentedControl 子 类 时 ， 我 们 不 能 像 平 常 那样 给 它 添 加 目标 -动作 组 合 。 由 于 子 类 会 捕获 所 有 touch down 事 件 ， 所 以 ， 如 果 开 发 者 义 针 对 
UIControl-EventValueChanged 事 件 设 定 了 目标 -动作 组 合 ， 那 么 实际 上 就 等 于 把 相关 的 回调 方法 重复 添加 了 一 遍 ， 等 到 用 户 点 击 控件 上 的 按钮 时 ， 系 统 就 会 回调 两 


2.7.1 ”实现 第 二 次 点 击 时 的 反馈 效果 


有 了 检测 第 二 次 点 击 的 能 力 之 后 ， 我 们 就 可 以 在 用 户 反 复 选取 同一 个 按钮 时 实现 一 些 反 馈 效 果 ， 比 方 说 ， 可 以 更 改 导 航 栏 的 标题 。 同 时 ， 还 可 以 考虑 另外 一 种 反 
馈 效果 ， 即 修改 控件 文本 的 某 些 属性 。 从 iOS 5.x 开 始 ，UIKit 就 提供 了 一 种 text attribute (文本 属性 ) 特性 ， 该 特性 很 适合 用 来 实现 刚 说 的 这 种 反馈 效果 。 
UlSegmentedControl 控 件 可 以 设置 一 些 基 于 状态 的 属性 。 我 们 可 通过 setTitle-TextAttributes: forState: 方法 给 用 户 所 选 定 的 按钮 添加 一 些 视觉 美化 效果 。 解 决 方 
案 2-4 使 用 该 方法 来 修改 按钮 的 文本 颜色 ， 当 用 户 初次 氮 击 某 按钮 时 ， 令 其 文本 变 为 白色 ， 重 复 氮 击 同 一 按钮 时 ， 再 将 其 改 为 红色 。 如 果 用 户 点 击 了 其 他 按钮 ， 那 么 残 
将 其 复原 ， 效 果 如 图 2-5 所 示 。 


Carrier = 8:43 PM 


Two (again #5) 


Three 


图 2-5 如 果 用 户 在 UISegmentedConttol 控 件 上 反复 点 击 某 个 已 经 选 定 的 按钮 ， 那 么 就 提供 一 种 视觉 反馈 效果 来 表示 这 种 不 太 常见 的 操作 。 我 们 通过 
setTitleTextAttributes:forState: 方 法 修饰 了 相关 文本 ， 以 便 进 一 步 强调 用 户 当 前 所 选 的 按钮 


2.7.2 ”控件 及 市 属性 的 字符 串 


从 iOS 6 开始 ，UIKit 中 包括 文本 框 、 文 本 视图 、 标 签 、 按 钮 及 刷新 控件 等 在 内 的 很 多 类 都 开始 支持 带 属 性 的 字符 串 (Attributed String) |") (也 就 是 Core Text 风 
格 的 字符 串 ) ， 开 友 者 可 以 用 这 种 字符 串 来 为 控件 的 文本 及 标题 设 定 相关 的 属性 : 


[myButton setAttributedTitle:attributedString forState:UIControlStateNormal] 


与 文本 有 关 的 属性 包括 字体 (font) 、 颜 色 (color) 、 阴 影 (shadow) 等 ， 而 iOS 7 又 扩充 了 开发 者 可 以 配置 的 属性 范围 。 打 开 NSAttributedString 类 的 参考 文 
12], Character Attributes 下 能 够 看 到 一 份 完整 的 属性 列表 ， 开 发 者 可 通过 Attributed String 来 修改 控件 文本 的 属性 。 


对 于 UlSegmentedControl 控 件 及 UlBarltem 来 说 ， 我 们 可 以 调用 setTitleText-Attributes: forState: 方法 来 设置 Attributed String。 开 发 者 需要 选用 适当 的 
key ( 键 ) 和 value ( 值 ) ， 把 待 设置 的 属性 放 到 NSDictionary 里 ， 然 后 传 给 该 方法 ， 下 面 列 出 了 几 种 键 供 大 家 参考 : 


- NSFontAttributeName 如 果 用 它 做 键 ， 那 么 值 应 该 是 个 UIFont 实 例 。 
- NSForegroundColorAttributeName 一 一 这 种 键 所 对 应 的 值 应 该 是 个 UIColor 实 例 。 


- NSShadowAttributeName 


如 果 把 它 当 成 键 ， 那 么 值 应 该 是 NSShadow 实 例 ， 而 开发 者 可 以 在 NSShadow 实 例 上 面 指定 阴影 的 偏 移 量 (offset) 、 模 糊 半径 
(blur radius) 及 颜色 (color) o 


: NSUnderlineStyleAttributeName 如 果 选 用 这 种 key， 那 么 值 应 该 是 NSNumbet 实 例 ， 这 个 NSNumbet 实 例 里 面 封装 的 数字 用 来 表示 所 需 的 下 划 线 效果 。 


比方 说 ， 解 决 方案 2-4 会 把 分 段 选择 控件 在 UIControlStateSelected 状 态 下 的 文本 颜色 设 为 日 色 。 若 用 尸 连续 两 次 选中 某 个 按钮 ， 则 将 该 按钮 的 文本 颜色 从 日 色 改 
为 红色 。 


解决 方案 2-4 ”创建 可 以 响应 第 二 次 点 击 的 UlsegmentedControl 子 类 
@class SecondTapSegmentedControl; 


@protocol SecondTapSegmentedControlDelegate <NSObject> 


- (void) performSegmentAction: (SecondTapSegmentedControl *) aDTSC; 
@end 


@interface SecondTapSegmentedControl : UISegmentedControl 
@property (nonatomic, weak) 


id <SecondTapSegmentedControlDelegate> tapDelegate; 
@end 


@implementation SecondTapSegmentedControl 
- (void) touchesEnded: (NSSet *)touches withEvent: (UIEvent *)event 


| 


[super touchesEnded:touches withEvent:event]; 


if (self.tapDelegate) 
[self.tapDelegate performSegmentAction:self]; 


| 


@end 


[1] 字面 意思 是 “ 带 属性 的 字符 串 ”， 实 际 可 以 理解 为 “ 带 样式 的 字符 串 ”。 为 了 和 编程 中 常见 的 “属性 ”一 词 相 区 隔 ， 译 文 酌情 保留 该 词 英文 原样 。 译 者 注 
[2] KER 48 83 X https: //developer.apple.com/library/ios/documentation/uikit/reference/NSAttributedString_ UIKit Addqditions/Refetence/Refetrence.html。 TRADE 


2.8” 开 天 控件 与 步 进 控件 


UlSwitch 对 象 (开关 控件 ) 提供 了 一 种 简单 的 开 / 关 切换 能 力 ， 用 户 可 以 在 这 两 种 布尔 状态 中 选择 一 种 。 开 关 (Switch) 控件 包含 一 个 可 供 设 定 的 属性 值 ， 它 的 名 
字 叫 作 on。 该 属性 的 值 可 能 是 YES， 也 可 能 是 NO， 有 具体 的 取 值 与 控件 的 当前 状态 有 关 。 你 可 以 用 程序 代码 直接 修改 这 个 属性 值 ， 以 更 新 控件 状态 ， 也 可 以 调用 
setOn: animated: 方法 来 修改 ， 该 方法 会 以 动画 效果 展示 状态 改变 的 过 程 。 


- (woid)didSwitch: (UISwitch *)theSwitch 


| 


o 


self.title = [NSString stringWithFormat :@"%@" 
theSwitch.on ? @"On" : @"OfE"]; 


- (void) viewDidAppear: (BOOL) animated 


| 


[super viewDidAppear:animated]; 
// Create the switch 
UISwitch *theSwitch - [[UISwitch alloc] init]; 


// Trigger on value changes 
[(theSwitch addTarget:self action:Gselector(didSwitch:) 


forControlEvents:UIControlEventValueChanged] ; 
[self.view addSubview:theSwitch] ; 


// Initialize to "off" 
theSwitch.on = NO; 
self.title = G"Off"; 


A 


在 上 述 代码 中 ， 如 果 开关 控件 的 状态 变 了 ， 我 们 就 修改 视图 控制 器 的 title 属 性 。1B 为 开关 控件 所 提供 的 选项 相对 来 说 比较 少 。 开 发 者 可 以 启用 该 控件 并 设置 其 初始 
值 ， 但 除 此 之 外 ， 就 没有 太 多 内 容 可 供 定 制 了 。 用 户 调 整 控件 的 时 候 ， 它 会 产生 UIControlEventValueChanged 事 件 。 


Qi: 不 要 把 UISwitch 实 例 起 名 叫 作 switch。switch 是 个 C 语 言 的 保留 字 ， 用 于 实现 条 件 控制 语句 。 许 多 iOS 开 发 者 都 容易 忽视 这 个 问题 。 


Ulstepper 控 件 〈 步 进 控件 ) 也 具备 与 滑 杆 及 Switch 控件 相似 的 功能 。 滑 杆 控件 给 出 了 一 段 连 续 的 取 值 学 围 ，Switch 控 件 提 供 了 一 种 简单 的 开 / 关 切换 万 式 ， 而 步 
Xt (Stepper) 控件 则 介 于 两 者 之 间 。 这 种 控件 里 面 有 两 个 按钮 ， 一 个 是 -， 一 个 是 +， 它 们 分 别 用 来 递增 及 递减 控件 的 value 属 性 。 


开发 者 一 般 会 通过 minimumValue 及 maximumValue 给 控件 设 定 合适 的 取 值 范围 ， 使 其 与 应 用 程序 的 某 些 实 际 特征 相符 ， 例 如 音量 、 速 度 以 及 其 他 一 些 可 以 度量 
的 值 等 。 然 而 ， 在 个 别 情况 下 ， 我 们 需要 令 用 户 在 控件 值 达 到 上 下 限 的 时 候 ， 依 然 能 够 继续 操作 它 。 把 控件 的 wrap 属 性 设 为 YES， 即 可 令 Stepper 控 件 有 具备 折 回 
(wrap) 能 力 。 这 样 的 话 ， 用 户 在 点 击 控件 按钮 时 ， 如 果 控 件 值 即将 超过 最 大 值 ， 那 么 它 就 会 折 回 到 最 小 值 ， 如 果 控 件 值 即将 低 于 最 小 值 ， 那 么 它 就 会 折 回 到 最 大 
值 。 


在 默认 情况 下 ，Stepper 控 件 会 自动 重复 (autorepeat) ， 也 就 是 说 ， 如 果 用 户 按 住 其 中 某 个 按钮 不 放 ， 那 么 控件 值 束 会 持续 变化 。 把 autorepeat 属 性 设 为 NO 即 
可 禁用 这 一 行为 。 而 每 次 点 击 按钮 时 的 变化 量 ， 则 由 stepValue 属 性 来 决定 。 不 要 把 stepValue 设 为 0 或 负数 ， 否 则 会 抛 出 运行 时 异 瘦 。 


对 于 Switch 与 Stepper 控 件 来 训 ， 其 界面 的 tint color 属 性 以 及 界面 的 图 像 都 是 可 以 定制 的 。 开 发 者 可 以 通过 onTintColor、tintColor 及 thumbTintColor 属 性 来 定 
制 Switch 控件 的 颜色 ， 并 通过 onlmage 及 Offlmage 属 性 来 定制 控件 的 图 像 。UlStepper 控 件 的 tintColor 属 性 可 供 定制 ， 另 外 ， 其 分 隔 条 (divider) 、 递 增 按钮 及 递 
减 按钮 的 图 像 也 可 以 按 状 态 来 分 别 配 置 。 


29 解决 方案 : 编写 UIContro| 的 子 类 


UIKit 提 供 了 许多 内 置 的 控件 ， 开 发 者 可 以 直接 将 其 运用 到 应 用 程序 里 。 这 些 控件 包括 Button (按钮 ) 、Switch 及 Slider 等 ， 但 我 们 不 应 束 此 止步 。 我 们 不 要 忌 是 
局 限 在 苹果 公司 所 提供 的 这 些 控件 里 ， 而 是 应 该 试 着 创建 自己 的 控件 。 


解决 方案 2-5 演 示 了 如 何 通 过 继承 UIControl 的 方式 来 从 头 开始 构 建新 的 控件 。 该 范例 创建 了 一 种 简单 的 颜色 选取 器 (color picker) 。 用 户 可 以 触摸 该 控件 ， 或 在 
控件 内 拖 忠 ， 以 选取 颜色 。 当 用 户 手 指 在 屏幕 上 左右 移动 时 ， 颜 色 的 色相 (hue) 会 改变 ;而 上 下 移动 时 ， 其 饱和 度 (saturation) 则 会 变化 。 颜 色 的 亮度 与 不 透明 程 
度 固定 为 100%。 


解决 方案 2-5 ”构建 自 定义 的 颜色 选取 控件 


@implementation ColorControl 


(instancetype)initWithFrame: (CGRect)frame 


self - [super initWithFrame:frame]; 
if (self) 
| 
self.backgroundColor = [UIColor grayColor] ; 


| 


return self; 


- (void)updateColorFromTouch: (UITouch *)touch 


// Calculate hue and saturation 

CGPoint touchPoint = [touch locationInView:self]; 

float hue = touchPoint.x / self.frame.size.width; 

float saturation - touchPoint.y / self.frame.size.height; 


// Update the color value and change background color 
self.value - [UIColor colorWithHue:hue 

saturation:saturation brightness:1.0f alpha:1.0f]; 
self.backgroundColor - self.value; 
[self sendActionsForControlEvents:UIControlEventValueChanged] ; 


// Continue tracking touch in control 
= (BOOL)continueTrackingWithTouch: (UITouch *) touch 
withEvent: (UIEvent *) event 


// Test if drag is currently inside or outside 
CGPoint touchPoint = [touch locationInView:self]; 
if (CGRectContainsPoint (self.frame, touchPoint) ) 
| 

// Update color value 

[self updateColorFromTouch:touch]; 


[self sendActionsForControlEvents: 
UIControlEventTouchDragInside]; 


else 


[self sendActionsForControlEvents: 
UIControlEventTouchDragOutside] ; 


return YES; 


// Start tracking touch in control 
- (BOOL) beginTrackingWithTouch: (UITouch *) touch 
withEvent: (UIEvent *) event 


// Update color value 
[self updateColorFromTouch:touch] ; 


// Touch Down 


[self sendActionsForControlEvents:UIControlEventTouchDown] ; 


return YES; 


// End tracking touch 
- (void) endTrackingWithTouch: (UITouch *) touch 
withEvent: (UIEvent *)event 


// Test if touch ended inside or outside 
CGPoint touchPoint = [touch locationInView:self] ; 
if (CGRectContainsPoint (self.bounds, touchPoint) ) 


{ 


// Update color value 
[self updateColorFromTouch: touch] ; 


[self sendActionsForControlEvents: 
UIControlEventTouchUpInside]; 


else 


[self sendActionsForControlEvents: 
UIControlEventTouchUpOut side] ; 


} 


// Handle touch cancel 
- (void) cancelTrackingWithEvent: (UIEvent *)event 


| 


[self sendActionsForControlEvents:UIControlEventTouchCancel]; 


| 


@end 
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题 。 


我 们 为 什么 要 自己 来 定制 控件 呢 ? 首先 ， 这 样 做 可 以 打造 自己 的 设计 风格 。 对 于 界面 中 放置 的 元 件 ， 其 风格 应 该 与 应 用 程序 的 整体 风格 相符 。 如 果 苹 果 公 司 内 置 


的 Switch、slider 及 其 他 GUI 元 件 不 能 与 你 目 己 的 程序 界面 自然 地 融合 起 来 ， 那 么 可 以 通过 上 自 定 义 的 控件 来 满足 应 用 程序 的 需求 ， 而 且 这 样 做 还 不 会 破坏 协调 一 致 的 设 
计 风 格 。 


其 次 ， 我 们 可 以 创建 出 苹果 公司 未 提供 的 控件 。 比 方 说 可 以 设计 这 样 一 种 控件 ， 它 能 够 展示 一 排 星 形 图 案 ， 使 用 户 可 以 通过 滑动 来 评分 ;还 可 以 设计 这 样 一 种 控 
件 ， 它 弹出 许多 颜色 不 同 的 蜡笔 ， 令 用 户 可 以 从 中 选择 某 种 颜色 。 这 些 自 定义 的 控件 使 用 己 可 以 通过 更 多 的 方式 来 操作 应 用 程序 ， 而 不 必 局 限于 SDK 提 供 的 Button 和 
Switch 等 内 置 控件 。 通 过 编写 UIControl 的 子 类 ， 我 们 很 容易 就 能 构建 出 醒目 的 交互 元 件 。 


最 后 ， 通 过 定制 控件 这 种 方式 ， 我 们 可 以 添加 一 些 无 法 直接 实现 或 无 法 通过 继承 固有 控件 类 而 实现 出 来 的 特性 。 开 发 者 只 需 编 写 少量 代码 ， 就 能 够 从 头 创建 出 自 
己 的 Button 和 Stepper， 也 就 是 说 ， 可 以 按 自 己 的 意愿 来 精确 地 调整 它们 的 交互 行为 。 


BOE mATX eer AS UHR Zee HARA Xa. Tere (HIG) PRIA. RARR ASRA AHAMENA, BRAGA 
App Store 提 交 程 序 时 ， 可 以 给 苹果 公司 留言 说 明 此 问题 。 你 需要 明确 表示 自己 是 创建 了 新 的 类 ， 而 不 是 使 用 了 私有 的 APl， 同 时 自己 也 没有 以 App Store 所 认定 的 不 
安全 方式 来 访问 苹果 公司 的 对 象 。 即 便 如 此 ， 评 审 人 员 也 依然 有 可 能 认为 程序 会 对 终端 用 尸 “ 造 成 困惑 ”， 从 而 拒绝 你 的 提交 。 


2.9.1 创建 控件 
构建 UIControl 的 过 程 一 般 分 为 四 步 。 正 如 解决 方案 2-5 所 示 ， 首 先 我 们 要 继承 UIControl， 以 创建 新 的 自 定义 类 。 然 后 要 在 新 类 的 初始 化 方法 中 安排 好 控件 的 样 
狐 。 接 下 来 编写 一 些 方 法 ， 以 便 追 踪 并 拦截 触摸 事件 ， 最 后 ， 产 生 相 关 事件 及 视 部 反馈 效果 。 


几乎 所 有 控件 都 会 提供 某 种 “ 值 ”。 比 方 说 ，Switch 控 件 有 isOn 值 ，Slider 控 件 有 浮 点 型 的 value 值 ，Text Field 控 件 有 text 值 。 目 定义 的 控件 应 该 提供 哪 种 值 由 开 
发 者 来 定 ， 可 以 是 整数 、 浮 点 数 、 字 符 串 ， 甚 至 可 以 像 解决 方案 2-5 这 样 提供 颜色 值 。 


解决 方案 2-5 所 使 用 的 控件 布局 基本 上 是 个 彩色 和 矩形。 有 些 复杂 的 控件 需要 更 为 复杂 的 布局 ， 但 即便 像 本 例 这 样 采 用 非常 简单 的 布局 ， 我 们 也 依然 能 够 向 用 户 提 供 
可 触摸 的 空间 ， 并 能 实现 出 适当 的 反馈 效果 ， 以 保持 清晰 的 用 尸体 验 。 


2.9.2 ” 追 际 触摸 事件 


UIControl 实 例 自己 有 一 套 应 对 触摸 事件 的 方法 。 这 些 方法 可 用 来 追 踊 用户 操作 控件 对 象 的 全 过 程 : 


- beginTrackingWithTouch: withEvent: 如 果 在 控件 范围 内 发 生 了 触摸 事件 ， 那 么 系统 就 会 调用 这 个 方法 。 


- continueTrackingWithTouch: withEvent: 如 果 相 关 的 触摸 事件 仍然 在 控件 范围 内 持续 ， 那 么 系统 就 反复 调用 这 个 方法 。 


- endTrackingWithTouch: withEvent: 该 方法 用 于 处 理事 件 结束 前 的 最 后 一 次 触摸 。 


- cancelTrackingWithEvent: 该 方法 用 于 处 理 触摸 操作 遭 到 取消 的 情况 。 


为 了 给 目 定 义 的 控件 添加 逻辑 代码 ， 开 发 者 可 以 在 UIControl| 子 类 里 实现 上 述 某 个 方法 ， 也 可 以 同时 实现 那 四 个 方法 。 解 决 方案 2-5 实 现 了 前 两 个 方法 ， 以 此 来 追 
路 用 户 对 控件 的 触摸 操作 ， 直 到 用 户 松 开 手 指 或 移出 控件 范围 。 


2.9.3” 派 友 控 件 事件 


控件 使 用 目标 -动作 组 合 来 传达 由 事件 所 引 友 的 变化 。 构 建新 控件 时 ， 开 发 者 必须 想 好 自己 的 对 象 将 会 产生 哪些 类 型 的 事件 ， 并 添加 相关 代码 来 触 友 那些 事件 。 


调用 sendActionsForControlEvents: 方法 即 可 为 自 定义 控件 添加 事件 派 友 功能 。 该 方法 可 以 把 某 个 事件 (比方 说 UIControlEventValueChanged 事 件 ) 发 送 给 
控件 的 目标 。 控 件 是 通过 向 UIApplication 单 例 发 消息 来 实现 这 一 操作 的 。 正 如 苹果 公司 的 开发 文档 所 说 ，UIApplication 对 象 是 所 有 消息 的 集中 派发 点 。 


无 论 控 件 类 多 么 简单 ， 开 发 者 都 应 该 尽量 多 支持 一 些 事件 类 型 ， 因 为 你 无 法 准确 预料 这 个 类 在 将 来 的 用 途 。 把 事件 类 型 提供 得 完备 一 些 可 以 使 控件 以 后 用 起 来 更 
加 灵活 。 对 于 本 例 这 种 非常 简单 的 控件 来 说 ， 解 决 方案 2-5 所 能 够 派 友 的 事件 类 型 已 经 算是 很 广泛 了 。 


事件 的 派发 时 机 很 大 程度 上 取决 于 你 要 构建 的 那个 控件 。 比 方 说 ，Switch 控 件 只 关注 touch up 事件 ， 因 为 它 的 值 只 有 在 这 个 时 候 才 会 改变 。 而 Slider 控 件 则 不 
同 ， 它 的 值 会 随 着 滑 块 的 移动 而 改变 ， 所 以 它 要 持续 关注 用 尸 手 指 的 移动 情况 ， 并 据 此 更 新 其 值 。 所 以 ， 开 发 者 应 该 根据 自己 控件 的 实际 情况 来 编写 代码 ， 并 且 要 注 
意 在 触摸 操作 的 各 个 阶段 适当 地 修改 控件 的 外 观 。 


2.10 ”解决 方案 : 构建 评分 所 用 的 Star Slider 探 件 


用 户 可 以 用 手指 划 过 Rating Slider (评分 滑 杆 ) 控件 上 面 的 若干 图 像 ， 以 此 来 对 电影 、 软 件 等 项 目 做 出 评分 。 在 基于 触摸 的 界面 中 ， 这 是 个 常见 的 功能 ， 但 是 用 
简单 的 Ulslider 实 例 却 不 容易 把 它 做 好 ， 因 为 UlSlider 控 件 的 值 是 浮 点 数 。 笔 者 构建 了 解决 方案 2-6 中 的 这 个 选取 器 (分 数 选取 器 ) ， 它 把 代表 分 数 的 那些 图 案 逐 次 排 
开 ， 将 用 户 所 能 选取 的 评分 限定 为 大 于 等 于 0 且 小 于 等 于 图 案 个 数 的 整数 。 当 用 户 触摸 星 形 图 案 时 ， 控 件 的 值 会 变化 ， 而 且 会 产生 相应 的 事件 ， 这 样 一 来 ， 应 用 程序 就 
可 以 像 对 待 其 他 UIControl 子 类 那样 来 处 理 用 户 对 Star Slider (含有 星 形 图 案 的 滑 杆 ) 控件 的 操作 了 。 


[3 


开 友 者 可 以 选用 任意 图 案 。 本 例 采 用 图 2-6 中 的 星 形 图 案 ， 不 过 你 完全 可 以 改 用 其 他 图 案 。 你 可 以 随意 选择 自己 喜欢 的 图 案 ， 只 要 能 分 别 为 on 和 off 这 两 种 状态 提 


供 对 应 的 图 像 就 行 。“ 心 ”、 "mm". “笑脸 ”等 图 案 也 都 可 以 考虑 。 你 还 可 以 修改 本 条 解决 方案 的 代码 ， 在 显示 控件 之 前 ， 指 定 预 设 的 评分 [1]。 


图 2-6 ”解决 方案 2-6 创 建 了 一 种 自 定义 的 star slider 控 件 ， 用 户 每 给 出 一 分 ， 控 件 中 就 会 有 一 颗 星 亮 起 。 我 们 在 块 里 面 编写 了 一 段 简单 的 动画 代码 ， 当 控件 值 发 生疏 变 


时 ， 相 应 的 星 形 图 案 会 呈现 出 放大 并 还 原 的 效果 


除了 简单 的 滑动 功能 ， 解 决 方案 2-6 还 添加 了 动画 效果 。 当 控件 有 了 新 值 的 时 候 ， 我 们 就 把 一 段 简单 的 动画 代码 放 企 块 里 面 ， 并 添加 到 当前 最 右 侧 的 那 颗 星 上 面 ， 
使 其 放大 ， 然 后 恢复 原状 ， 这 样 就 可 以 在 原 有 的 视 竞 效果 之 上 再 向 用 户 提供 一 种 即时 的 反馈 。 图 2-6 里 的 图 案 是 从 模拟 器 的 屏幕 中 抓 下 来 的 ， 而 用 户 在 真正 使 用 应 用 程 
序 时 ， 触 摸 的 却 是 设备 的 屏幕 ， 所 以 ， 我 们 要 刻意 把 动画 做 得 夸张 一 些 ， 使 反馈 效果 的 范围 能 够 超过 用 户 的 手指 大 小 。 笔 者 选 了 个 尺寸 比较 小 的 图 案 ， 并 在 动画 效果 


中 将 它 放 大 到 原 尺寸 的 150%， 你 可 以 根据 自己 程序 的 实际 需求 来 选取 大 小 适当 的 图 案 ， 并 指定 合适 的 放大 倍数 。 


解决 方案 2-6 ”构建 以 图 案 个 数 来 表示 评分 的 Star slider 控 件 


@implementation StarSlider 
- (instancetype)initWithFrame: (CGRect)aFrame 
{ 
self = [super initWithFrame:aFrame] ; 
if (self) 
| 
// Lay out five stars, with spacing between and at the ends 
float offsetCenter - WIDTH; 
for (inti = 1; i <= 5; i++) 
| 
UIImageView *imageView = [[UIImageView alloc] 
initWithFrame:CGRectMake(0.0f, 0.0f, WIDTH, WIDTH)]; 
imageView.image - OFF ART; 
imageView.center = CGPointMake (offsetCenter, 
self.intrinsicContentSize.height / 2.0f); 
offsetCenter += WIDTH * 1.5f; 
[self addSubview:imageView]; 


| 


// Place on a contrasting background 
self.backgroundColor - 
[[UIColor blackColor] colorWithAlphaComponent:0.25f]; 


return self; 


- (CGSize)intrinsicContentSize 


| 


return CGSizeMake (WIDTH * 8.0f, 34.0£); 


| 


// Handle the value update for the touch point 


- (void)updateValueAtPoint: (CGPoint)point 


( 


int newValue = 0; 
UIImageView *changedView - nil; 


// Iterate through stars to check against touch point 
for (UIImageView *eachItem in [self subviews]) 


{ 


if (point.x « eachItem.frame.origin.x) 


{ 
} 


else 


{ 


eachlItem.image = OFF ART; 


changedView = eachItem; // last item touched 
eachlItem.image - ON ART; 
newValue++; 


// Handle value change 
if (self.value != newValue) 
{ 
self.value = newValue; 
[self sendActionsForControlEvents: 
UIControlEventValueChanged] ; 


// Animate the new value with a zoomed pulse 
[UIView animateWithDuration:0.15f 
animations:^([changedView.transform = 
CGAffineTransformMakeScale(1.5f, 1.5f);] 
completion:^(BOOL done) { [UIView 
animateWithDuration:0.1f 
animations:^(changedView.transform = 
CGAffineTransformIdentity;}];}]; 


- (BOOL)beginTrackingWithTouch: (UITouch *) touch 
withEvent: (UIEvent *) event 


// Establish touch down event 
CGPoint touchPoint = [touch locationInView:self]; 
[self sendActionsForControlEvents:UIControlEventTouchDown] ; 


// Calculate value 


[self updateValueAtPoint:touchPoint]; 
return YES; 


- (BOOL)continueTrackingWithTouch: (UITouch *)touch 


withEvent: (UIEvent *)event 


// Test if drag is currently inside or outside 
CGPoint touchPoint - [touch locationInView:self]; 
if (CGRectContainsPoint(self.frame, touchPoint)) 
[self sendActionsForControlEvents: 
UIControlEventTouchDragInside]; 
else 
[self sendActionsForControlEvents: 
UIControlEventTouchDragOutside]; 


// Calculate value 
[self updateValueAtPoint: [touch locationInView:self]]; 


return YES; 


- (void)endTrackingWithTouch: (UITouch *)touch 
withEvent: (UIEvent *)event 


// Test if touch ended inside or outside 
CGPoint touchPoint = [touch locationInView:self]; 
if (CGRectContainsPoint(self.bounds, touchPoint)) 
[self sendActionsForControlEvents: 
UIControlEventTouchUpInside]; 
else 
[self sendActionsForControlEvents: 
UIControlEventTouchUpOutside]; 


- (void)cancelTrackingWithEvent: (UIEvent *)event 


| 


// Cancelled touch 
[self sendActionsForControlEvents:UIControlEventTouchCancel]; 


| 


@end 


解决 方案 2-6 在 定制 UIControl 时 所 采用 的 方式 与 解决 方案 2-5 类 似 ， 也 是 追踪 触摸 操作 的 生命 期 ， 然 后 在 适当 的 时 机 产生 事件 ， 只 不 过 这 次 的 布局 及 视 党 反馈 效果 
与 解决 万 案 2-5 有 所 区 别 。 本 条 解决 方案 只 用 了 少量 代码 就 为 控件 添加 了 星 形 图 案 ， 并 实现 了 反馈 效果 ， 由 此 可 见 ， 通 过 继承 UIControl 类 来 定制 自己 的 控件 确实 是 件 
非常 信 单 的 事 。 


译 者 注 


[1] 预 设 几 分 ， 就 会 亮 起 几 颗 星 。 


2.11 解决 方案 : 构建 触摸 转盘 控件 


这 条 解决 方案 将 会 制作 一 种 与 老式 iPod 类 似 的 触摸 转盘 (Touch Wheel) 控件 ， 它 提供 了 一 种 可 以 无 限 滚 动 的 输入 方式 。 无 论 是 顺 时 针 旋转 还 是 逆 时 针 旋转 ， 该 
控件 的 值 都 会 随 之 增加 或 减少 。 每 转动 一 整 圈 (也 就 是 360 度 ) ， 控 件 的 值 就 改变 1.0。 顺 时 针 旋 转 会 令 控件 值 增 大 ， 而 逆 时 针 旋 转 则 会 令 其 减 小 。 每 次 触摸 时 所 产生 
的 控件 值 会 累积 起 来 ， 不 过 开发 者 也 可 以 重 置 该 控件 ， 只 需 把 其 value 属 性 设 为 0.0 即 可 。 虽 说 该 属性 并 不 是 UIControl 实 例 中 的 标准 属性 ， 但 很 多 控件 都 有 个 名 叫 
value 的 属性 。 

本 条 解决 方案 会 以 控件 中 心 点 为 原点 计算 当前 触摸 点 的 坐标 ， 并 算出 用 户 的 触摸 操作 所 对 应 的 变化 量 。 在 用 户 移动 手指 的 过 程 中 ， 这 段 代码 会 算出 这 一 次 与 上 一 
次 之 间 的 角度 差 ， 并 据 此 更 新 控件 当前 的 值 。 比 方 说 ， 如 果 手 指 在 控件 内 旋转 了 3 圈 ， 那 么 新 的 控件 值 就 会 比 原来 多 3 或 少 3， 是 增加 还 是 减少 要 看 移动 的 方向 是 顺 时 针 
还 是 逆 时 针 。 


解决 方案 2-7 定 义 了 一 个 简单 的 触摸 转盘 控件 ， 它 能 够 记录 手指 的 旋转 ， 但 除 此 之 外 就 没有 太 多 的 功能 了 。 最 初版 iPod 的 滚轮 (scroll wheel) 有 5 个 地 方 可 供 点 
击 ， 分 别 是 圆圈 中 间 以 及 滚轮 上 、 下 、 左 、 右 四 个 部 位 。 读 者 可 以 做 个 练习 ， 为 解决 方案 2-7 中 的 控件 添加 点 击 功能 ， 并 使 其 能 够 产生 类 似 按钮 那样 的 事件 (比方 说 
UIControlEventTouchUplnside 事 件 ) 。 


解决 方案 2-7 ”构建 触摸 转盘 控件 
@implementation ScrollWheel 


// Layout the wheel 
- (instancetype)initWithFrame: (CGRect)aFrame 
| 

self = [super initWithFrame:aFrame]; 

if (self) 


| 


// This control uses a fixed 200x200 sized frame 
CGRect f; 

f.origin - aFrame.origin; 

f.size - self.intrinsicContentSize; 


self.frame - f; 


// Add the touch wheel art 

UIImageView *imageView - [[UIImageView alloc] 
initWithImage: [UIImage imageNamed:G"wheel.png"]]; 

[self addSubview:imageView]; 


) 


return self; 


- (BOOL)beginTrackingWithTouch: (UITouch *)touch 
withEvent: (UIEvent *)event 


CGPoint point = [touch locationInView:self] ; 


// Center point of view in own coordinate system 

CGPoint centerPt = CGPointMake(self.bounds.size.width / 2.0f, 
self.bounds.size.height / 2.0f); 

// First touch must touch the gray part of the wheel 

if (!pointInsideRadius (point, centerPt.x, centerPt)) return NO; 

if (pointInsideRadius (point, 30.0f, centerPt)) return NO; 


// Set the initial angle 
self.theta = getAngle([touch locationInView:self], centerPt); 


// Establish touch down 
[self sendActionsForControlEvents:UIControlEventTouchDown] ; 


return YES; 


- (CGSize) intrinsicContentSize 


{ 


return CGSizeMake (200, 200); 


- (BOOL) continueTrackingWithTouch: (UITouch *) touch 
withEvent: (UIEvent *)event 


CGPoint point = [touch locationInView:self] ; 


// Center point of view in own coordinate system 
CGPoint centerPt = CGPointMake(self.bounds.size.width / 2.0f, 
self.bounds.size.height / 2.0f); 


// Touch updates 
if (CGRectContainsPoint(self.frame, point)) 
[self sendActionsForControlEvents: 
UIControlEventTouchDragInside]; 
else 
[self sendActionsForControlEvents: 
UIControlEventTouchDragOutside]; 


// Falls outside too far, with boundary of 50 pixels? 
if (!pointInsideRadius(point, centerPt.x + 50.0f, centerPt)) 
return NO; 


float newtheta - getAngle([touch locationInView:self], centerPt); 
float dtheta - newtheta - self.theta; 


// correct for edge conditions 
int ntimes - 0; 
while ((ABS(dtheta) > 300.0f) && (ntimes++ < 4)) 
{ 
if (dtheta > O.0f) 
dtheta -= 360.0f; 
else 
dtheta += 360.0f; 


| 


// Update current values 
self.value -- dtheta / 360.0f; 
self.theta - newtheta; 


// Send value changed alert 
[self sendActionsForControlEvents:UIControlEventValueChanged]; 


return YES; 


- (void)endTrackingWithTouch: (UITouch *)touch 
withEvent: (UIEvent *)event 


// Test if touch ended inside or outside 
CGPoint touchPoint - [touch locationInView:self]; 
if (CGRectContainsPoint(self.bounds, touchPoint)) 
[self sendActionsForControlEvents: 
UIControlEventTouchUpInside] ; 
else 
[self sendActionsForControlEvents: 
UIControlEventTouchUpOutside] ; 


- (void) cancelTrackingWithEvent: (UIEvent *) event 


| 


// Cancel 
[self sendActionsForControlEvents:UIControlEventTouchCancel]; 


| 


@end 


2.12 解决 方案 : 创建 拉 电 控件 


我 们 可 以 假想 屏幕 上 方 有 条 强 泰 ， 当 用 户 使 劲 向 下 拉 搜 它 的 时 候 ， 会 响起 铃声 ， 或 是 导致 系 统 通过 控件 的 目标 -动作 机 制 触 友 某 种 事件 。 例 如 ， 该 事件 可 能 会 展示 
出 一 个 辅助 的 视图 (secondary view) ， 也 可 能 会 局 动 下 载 操 作 ， 还 可 能 会 播放 视频 ， 等 等 。 解 决 方案 2-8 所 构建 的 这 个 控件 的 样子 像 是 一 条 丝 市 。 用 户 必 须 从 其 顶端 
开始 操作 它 ， 而 且 还 要 向 下 拉 搜 足够 大 的 距离 ， 才 能 触 友 相 关 的 事件 。 其 后 ， 丝 市 长 度 会 恢复 到 原状 ， 以 等 待 下 一 次 操作 。 
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件 发 给 目标 -动作 中 的 相关 目标 对 象 


图 2-7 演 示 了 本 解决 方案 所 构建 的 控件 ， 它 案 贴 着 辅助 视图 的 下 沿 。 用 尸 向 下 拉 搜 ， 即 可 看 到 辅助 视图 ， 若 是 再 次 拉 蝶 ， 则 会 使 辅助 视图 重新 回 到 屏幕 之 外 。 


2.12.1 ”为 控件 添加 提示 效果 


本 解决 万 案 的 一 个 难点 是 如 何 告 诉 用 己 丝 市 状 的 图 案 是 可 以 拉 岛 的 。 用 户 看 到 这 个 红色 图 形 之 后 ， 不 一 定 能 立刻 想到 这 是 个 可 供 操 作 的 控件 。 

开 上 友 者 Matthijs Hollemans 想 出 了 一 个 简单 的 办 法 可 以 解决 此 间 题 。 那 就 是 ， 在 用 尸 操 作 控 件 之 前 ， 令 丝 市 图 案 上 下 拌 动 (wiggle) 几 次 ,每 次 拌 动 之 间 相 隔 数 
秒 。 这 样 做 可 以 使 用 尸 注 意 到 这 是 个 控件 ， 等 用 户 能 够 正确 操作 该 控件 之 后 ， 束 尽快 去 掉 这 种 效果 。 如 果 用 户 经 常 使 用 这 个 程序 ， 那 么 可 以 考虑 添加 一 项 系统 配置 ， 
令 其 可 以 关闭 提示 效果 。 


- (void)wiggle 


( 


if (wiggleCount++ > 3) return; 


// Wiggle slightly 
[UIView animateWithDuration:0.25f animations: ~*() { 
pullImageView.center = CGPointMake | 
pullImageView.center.x, 
pullImageView.center.y + 10.0f); 
} completion: *(BOOL finished) { 
[UIView animateWithDuration:0.25f animations: ~() { 
pullImageView.center = CGPointMake ( 
pullImageView.center.x, 
pullImageView.center.y - 10.0f); 


}]; 
1; 


// Repeat until the count is overridden or it wiggles 3 times 
[self performSelector:@selector (wiggle) 
withObject:nil afterDelay:4.0f]; 


对 于 操作 方式 不 太 明 显 的 控件 来 说 ， 可 以 添加 基于 加 速 计 的 移动 (accelerometer-based movement) 效果 ， 以 引起 用 户 注 意 。 开 上 友 者 Charles Chox, Wiz 
令 丝 市 随 着 设备 的 移动 而 做 出 轻微 的 有 反应。 这 种 办 法 也 可 以 使 用 户 明 日 控件 的 用 法 。 


iOS 7 引入 了 运动 效果 (motion effect， 动 画 效果 ) ， 它 用 一 套 新 的 声明 式 API 大 幅 缩减 了 实现 此 类 效果 所 需 的 代码 量 。 程 序 清单 2-1 就 演示 了 这 么 一 种 运动 效 
果 ， 它 可 以 把 设备 加 速 计 上 面 所 发 生 的 事件 同 U1Kit 控 件 的 值 关 联 起 来 。 开 发 者 只 需 创 建 UIMotionEffect 子 类 的 实例 (目前 系统 只 提供 了 一 种 UIMotionEffect 子 类 ， 
即 UlinterpolatingMotionEffect) ， 并 将 视图 中 应 该 具备 运动 效果 的 值 设 为 keyPath， 然 后 把 UIMotionEffect 实 例 和 目标 视图 关联 起 来 即 可 。 


程序 清单 2-1 添加 运动 效果 


- (void)startMotionEffects 
( 
UIInterpolatingMotionEffect *motionEffectX = 
[[UIInterpolatingMotionEffect alloc] 
initWithKeyPath:G"center.x" 
type:UIInterpolatingMotionEffectTypeTiltAlongHorizontalAxis]; 
UIInterpolatingMotionEffect *motionEffectY = 
[[UIInterpolatingMotionEffect alloc] 


initWithKeyPath:G"center.y" 

type:UIInterpolatingMotionEffectTypeTiltAlongVerticalAxis]; 
motionEffectX.minimumRelativeValue = @-15.0; 
motionEffectX.maximumRelativeValue = 915.0; 
motionEffectY.minimumRelativeValue = @-15.0; 
motionEffectY.maximumRelativeValue = @15.0; 
motionEffectsGroup = [[UIMotionEffectGroup alloc) init]; 
motionEffectsGroup.motionEffects = 

@[motionEffectX, motionEffectY]; 

[pullImageView addMotionEffect :motionEffectsGroup] ; 


你 可 以 从 苹果 公司 的 程序 中 获取 灵感 。 苹 果 公 司 在 iOs 系 统 中 制作 了 许多 这 样 的 提示 效果 ， 例 如 对 于 滑动 解锁 操作 来 说 ， 它 会 通过 一 段 简单 的 动画 效果 ， 用 提示 性 
的 文本 写 出 应 该 滑动 的 部 位 以 及 所 需 的 滑动 方式 。 


2.12.2 Wize 
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处 理 这 次 触摸 ， 而 控件 也 不 会 响应 它 。 即 便 解 摸 点 确实 在 控件 的 框架 之 中 ， 但 只 要 不 在 图 案 范 围 内 ， 我 们 残 不 做 出 响应 。 其 次 ,根据 丝 市 图 案 的 位 图 信息 来 确认 用 户 
触摸 的 是 不 是 图 案 中 不 透明 的 部 分 。 从 图 2-7 中 可 以 看 到 ， 丝 带 图 案 的 下 方 有 个 倒 V 字 形 的 缺口 。 在 缺口 里 发 生 的 触摸 操作 不 会 使 控件 启动 后 续 的 追踪 过 程 。 我 们 要 在 
解决 方案 的 代码 中 比 对 触摸 点 和 图 案 中 的 相关 像素 。 假 如 不 透明 度 小 于 等 于 85， 或 者 说 透明 度 已 达 67% 左 右 ， 那 么 程序 束 不 认为 用 户 触 摸 了 控件 。 


解决 方案 2-8 ”构建 画 有 丝 市 图 案 的 可 拉 搜 式 控件 


- (BOOL)beginTrackingWithTouch: (UITouch *)touch 
withEvent: (UIEvent *)event 


// Establish touch down event 
CGPoint touchPoint = [touch locationInView:self]; 
CGPoint ribbonPoint = [touch locationInView:pullImageView] ; 


// Find the data offset in the image 

Byte *bytes = (Byte *) ribbonData.bytes; 

uint offset = alphaOffset (ribbonPoint.x, ribbonPoint.y, 
pullImageView.bounds.size.width) ; 


// Test for containment and alpha value to disallow touches 
// outside the ribbon and inside the notched area 


if (CGRectContainsPoint (pullImageView.frame, touchPoint) && 
(bytes[offset] > 85)) 


[self sendActionsForControlEvents:UIControlEventTouchDown] ; 
touchDownPoint = touchPoint; 
return YES; 


return NO; 


- (BOOL)continueTrackingWithTouch: (UITouch *)touch 
withEvent: (UIEvent *) event 


// Once the user has interacted, don't wiggle any more 
wiggleCount = CGFLOAT MAX; 


// Test for inside/outside touches 
CGPoint touchPoint = [touch locationInView:self]; 
if (CGRectContainsPoint(self.frame, touchPoint) ) 
[self sendActionsForControlEvents: 
UIControlEventTouchDragInside] ; 


else 
[self sendActionsForControlEvents: 


UIControlEventTouchDragOutside] ; 


// Adjust art based on the degree of drag 

CGFloat dy = MAX(touchPoint.y - touchDownPoint.y, 0.0f); 
dy = MIN(dy, self.bounds.size.height - 75.0f); 
pullImageView.frame = CGRectMake(10.0f, 
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dy + 75.U0t - ribbonlimage.size.heignht, 
ribbonlImage.size.width, ribbonImage.size.height); 


// Detect if travel has been sufficient to trigger everything 
if (dy > 75.0f) 
( 
// It has. Play a click, trigger the callback, and roll 
// the view back up. 
[self playClick]; 
[UIView animateWithDuration:0.3f animations:^()[( 
pullimageView.frame = CGRectMake(10.0f, 
75.0£ - ribbonImage.size.height, 
ribbonimage.size.width, 
ribbonlImage.size.height); 
) completion:^(BOOL finished) { 
[Self sendActionsForControlEvents: 
UIControlEventValueChanged] ; 


yl; 


// No more interaction needed or allowed 
return NO; 


// Continue interaction 
return YES; 


- (void)endTrackingWithTouch: (UITouch *)touch 
withEvent: (UIEvent *)event 


// Test if touch ended inside or outside 
CGPoint touchPoint - [touch locationInView:self]; 
if (CGRectContainsPoint(self.bounds, touchPoint)) 
[self sendActionsForControlEvents: 
UIControlEventTouchUpInside] ; 
else 
[self sendActionsForControlEvents: 
UIControlEventTouchUpOutside] ; 


// Roll back the ribbon, regardless of where the touch ended 
[UIView animateWithDuration:0.3f animations:^()( 
pullImageView.frame = CGRectMake(10.0f, 
75.0f - ribbonImage.size.height, 


ribbonlImage.size.width, ribbonImage.size.height); 


Fli 


// Handle cancelled tracking 


- (void)cancelTrackingWithEvent: (UIEvent *)event 


| 


[self sendActionsForControlEvents:UIControlEventTouchCancel]; 


解决 方案 中 的 范例 代码 并 没有 考虑 拉 伸 之 后 的 图 案 ， 它 假定 图 案 与 屏幕 上 绘制 出 来 的 内 容 是 1 比 1 的 关系 。 假 如 你 要 调整 控件 图 案 的 尺寸 ， 可 以 把 透明 度 测试 去 
掉 ， 或 是 对 代码 进行 改编 。 


启动 追踪 (tracking) 过 程 之 后 ， 控 件 就 会 开始 关注 触摸 点 的 移动 以 及 用 户 手指 的 向 上 、 向 下 拖 钨 操作 了 。 在 本 解决 方案 中 ， 如 果 触 摸 点 的 移动 距离 超过 75 个 点 
(point) ， 那 么 就 触发 控件 事件 ， 它 会 向 其 目标 对 象 发 送 UIControlEventValueChanged 事 件 。 严 格 来 说 ， 该 控件 并 没有 Value ( 值 ) 这 个 概念 ， 但 若 改 成 触发 
UIControlEventTouchUplnside 事 件 ， 则 似乎 又 与 控件 的 操作 方式 不 太 相 符 。 


如 果 用 户 的 拉 搜 操作 已 经 到 位 ， 那 么 continueTrackingWithTouch 方 法 就 返回 NO， 意 思 是 说 追踪 流程 已 经 结束 ， 而 控件 也 已 经 完成 了 它 在 这 次 操作 中 的 任务 。 
若是 手指 移动 的 距离 没有 达到 触发 控件 事件 的 最 小 拉 搜 距离 ， 或 是 用 户 在 尚未 拉 搜 到 位 时 就 提前 停止 了 操作 ， 那 么 程序 会 把 控件 恢复 到 开始 时 的 样子 。 这 会 令 丝带 图 
案 复原 ， 使 用 户 明 白 现 在 可 以 进行 下 一 次 操作 了 。 


2.13 ”解决 万 案 : 构建 目 定义 的 锁定 控件 


写 完 本 书 上 一 版 之 后 ， 笔 者 曾经 为 某 次 开发 者 聚会 制备 了 图 2-8 中 的 锁定 控件 (Lock Control) 。 当 时 很 多 人 都 要 求 把 它 的 制作 过 程 放 在 本 书 这 一 版 里 面 。 以 
UIContro| 为 基础 来 构建 这 个 控件 非常 容易 。 它 由 四 部 分 组 成 : 背景 图 版 (backdrop) 、 表 示 锁 定 和 解锁 状态 的 图 像 、 滑 块 (thumb) 以 及 拖 遇 滑 块 时 所 沿 的 轨道 
(drag track) 。 
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E2-8 这 是 个 简单 的 锁定 控件 ， 如 果 用 户 能 将 滑 块 拖 过 至 少 3/4 的 轨道 长 度 ， 那 么 该 控件 就 会 解锁 并 消失 


解决 方案 2-9 列 出 了 实现 控件 行为 所 用 的 代码 。 这 条 解决 方案 对 操作 的 判定 非 单 宽 松 。 只 要 触摸 操作 友 生 在 轨道 及 滑 块 周围 的 20 点 以 内 融 算 有 效 。 这 是 个 非 芝 粗放 
(Spartan) 的 控件 ， 它 留 出 了 很 大 一 片 地 方 (相当 于 常人 指 尖 的 一 半 大 小 ) ， 使 用 户 可 以 更 加 从 容 地 执行 解锁 操作 。 


与 判定 触摸 时 所 用 的 宽松 程度 类 似 ， 用 户 只 需 把 滑 块 拖 过 大 约 75% 的 轨道 长 度 ， 即 可 完成 解锁 操作 。 这 里 也 留 下 了 一 定 的 余地 ， 我 们 既 能 确保 用 户 真 的 是 要 完成 
解锁 操作 ， 同 时 又 不 至 于 令 用 户 因 为 精确 度 要 求 太 过 严 奇 而 感 况 麻烦 。 滑 块 的 回 弹 效 果 也 是 经 历 了 好 几 次 用 户 测试 才 调 整 好 的 ， 如 果 用 户 在 尚未 完成 解锁 之 前 融 松 开 
了 滑 块 ， 那 么 它 会 向 左 恢 复 到 原来 的 位 置 。 访 控件 在 用 户 解 锁 之 后 的 消失 过 程 需要 持续 半 秒 钟 ， 笔 者 设 定 的 这 个 时 长 比 一 般 控 件 的 变化 速度 要 稍微 长 一 点 。 比 方 说 ， 
键盘 通常 只 需要 过 1/3 秒 就 会 显示 出 来 。 


解决 方案 2-9 ”创建 锁定 控件 


- (BOOL)beginTrackingWithTouch: (UITouch *)touch 
withEvent: (UIEvent *)event 


// Test touches for start conditions 
CGPoint touchPoint - [touch locationInView:self]; 
CGRect largeTrack - 
CGRectInset(trackView.frame, -20.0f, -20.0f); 
if (!CGRectContainsPoint (largeTrack, touchPoint) ) 
return NO; 
touchPoint = [touch locationInView:trackView] ; 
CGRect largeThumb = 
CGRect Inset (thumbView.frame, -20.0f, -20.0f); 
if (!CGRectContainsPoint (largeThumb, touchPoint) ) 
return NO; 
// Begin tracking 
[self sendActionsForControlEvents:UIControlEventTouchDown] ; 


return YES; 


- (BOOL)continueTrackingWithTouch: (UITouch *)touch 
withEvent: (UIEvent *)event 


// Strayed too far out? 
CGPoint touchPoint = [touch locationInView:self] ; 
CGRect largeTrack - 
CGRectInset(trackView.frame, -20.0f, -20.0f); 
if (!CGRectContainsPoint (largeTrack, touchPoint)) 
{ 
// Reset on failed attempt 
[UIView animateWithDuration:0.2f animations:^()[( 
NSLayoutConstraint *constraint - 
[trackView constraintNamed: THUMB POSITION TAG]; 
constraint.constant = 0; 
[trackView layoutIfNeeded] ; 
rig 


return NO; 


// Track the user movement by updating the thumb 
touchPoint = [touch locationInView:trackView] ; 
[UIView animateWithDuration:0.1f animations:%*() { 
NSLayoutConstraint *constraint = 
[trackView constraintNamed: THUMB POSITION TAG]; 
constraint.constant = touchPoint.x; 
[trackView layoutIfNeeded]; 
Hl; 


return YES; 


- (void)endTrackingWithTouch: (UITouch *)touch 
withEvent: (UIEvent *)event 


// Test if touch ended with unlock 
CGPoint touchPoint = [touch locationInView:trackView] ; 
if (touchPoint.x > trackView.frame.size.width * 0,750) 
{ 

// Complete by unlocking 

_value = 0; 

self.userInteractionEnabled = NO; 

[self sendActionsForControlEvents: 

UIControlEventValueChanged] ; 


// Fade away and remove 
[UIView animateWithDuration:0.5f animations: 
“(){self.alpha = 0.0£;) 
completion: 


^(BOOL finished) { [self removeFromSuperview] ; 


ar 


else 


| 


// Reset on failed attempt 
[UIView animateWithDuration:0.2f animations:^()[ 
NSLayoutConstraint *constraint - 
[trackView constraintNamed: 
THUMB POSITION TAG]; 
constraint.constant = 0; 
[trackView layoutIfNeeded] ; 


FE 


if (CGRectContainsPoint (trackView.bounds, touchPoint)) 


| 


[self sendActionsForControlEvents: 
UIControlEventTouchUpInside]; 


else 


[self sendActionsForControlEvents: 
UIControlEventTouchUpOutside]; 


- (void)cancelTrackingWithEvent: (UIEvent *)event 


| 


[self sendActionsForControlEvents: 
UIControlEventTouchCancel] ; 


添加 页 面 指 示 器 控件 


UIPageControl 类 会 提供 许多 圆 点 ， 并 将 其 中 一 个 加 亮 ， 用 来 表示 当前 所 显示 的 内 容 是 多 页 视图 中 的 哪 一 页 。iOs 的 SpringBoard 主 屏幕 融 用 到 了 这 种 控件 ， 大 家 
可 以 看 到 屏幕 底部 显示 的 那 几 个 小 圆 点 。 不 过 UIPageControl 类 有 个 缺 点 ， 融 是 操控 起 来 非 党 困难， 用户 很 难 准 确 氮 击 该 控件 ， 这 通 单 会 使 他 们 竞 得 麻烦 。 所 以 ， 如 
果 要 使 用 这 个 控件 ， 束 应 该 另外 提供 一 套 切 换 页 面 的 方式 ， 把 UIPageControl 只 当成 个 指示 器 来 用 束 好 。 


图 2-9 演 示 了 含有 3 个 页 面 的 Page Control (页 面 控件 ) 。 在 指示 当前 页 面 的 那个 亮色 小 圆 点 左 方 或 右 方 点 击 ， 就 会 触发 UIControlEventValueChanged 事 件 ， 此 
时 系统 将 会 调用 开发 者 所 设 定 的 动作 。 你 可 以 通过 currentPage 属 性 查询 控件 的 当前 值 ， 也 可 以 通过 设置 humberOfPages 属 性 来 修改 可 用 的 页 面 数量 。SpringBoard 
把 表示 页 面 的 圆 点 个 数 限制 为 9 个 ， 不 过 你 自己 的 应 用 程序 可 以 使 用 更 多 的 小 圆 点 ， 尤 其 是 在 横 屏 模式 下 。 
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图 2-9 在 需要 显示 多 个 页 面 的 时 候 ， 我 们 可 以 通过 UIPageConttol 类 提供 一 种 能 够 接受 用 户 操作 的 指示 器 。 用 户 在 当前 亮 起 的 小 圆 点 左 方 或 右 方 点 击 ， 即 可 选 定 新 的 页 
面 ， 至 少 在 理论 上 是 这 样 的 。 不 过 ，UIPageControl 控 件 很 难 操作 ， 它 需要 非常 高 的 点 击 精确 度 才 行 ， 所 以 ， 其 响应 能 力 比 较 低 


解决 方案 2-10 用 UlscrollView 实 例 来 显示 多 张 图 像 ， 其 效果 如 图 2-10 所 示 。 用 户 可 以 通过 滑动 (swipe) 来 浏览 图 片 ， 而 页 面 指示 器 也 会 随 之 更 新 。 另 外 ， 用 户 还 
可 以 直接 在 页 面 控 件 上 点 击 ,， 使 UlScrollView 把 用 户 所 选 的 页 面 展示 出 来 。 我 们 通过 目标 -动作 机 制 给 UIPageControl 控 件 添加 了 一 个 回调 方法 ， 同 时 又 在 
UlscrollView 控 件 的 委托 里 编写 了 另外 一 个 回调 方法， 这样 融 实现 出 了 这 套 两 者 联动 的 操作 方案 。 由 于 每 个 回调 方法 都 会 更 新 另外 一 个 对 象 ， 所 以 两 个 对 象 能 够 紧密 
结合 起 来 。 
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图 2-10 iOS 7 讲究 内 容 至 上 。 在 某 些 应 用 程序 的 界面 元 件 中 ， 只 有 页 面 控件 和 iOS 状 态 栏 是 可 见 的 ， 二 者 都 登 放 在 屏幕 内 容 上 方 


使 用 UIPageControl 控 件 时 ， 开 上 友 者 弟 犯 的 错误 是 没有 把 控件 拓展 到 足够 宽 ， 也 融 是 没有 在 小 圆 点 的 左右 两 侧 留 下 可 供用 户 点 击 的 区 域 。 访 控件 的 固有 大 小 与 它 
的 可 见 尺 寸 非 常 接近 ， 这 束 严 重 限 制 了 可 供用 户 点 击 的 区 域 。 假 如 直接 将 没有 拓宽 的 控件 居中 ， 那 么 控件 就 会 很 难 操作 。 除 非 用 户 操作 UIPageControl 时 可 能 与 其 他 
触摸 元 件 相 冲突 ， 否 则 开发 者 应 该 设 定 Auto Layout 约 束 或 设 定 其 框架 ,使 之 与 上 级 视图 同 宽 。 


解决 方案 2-10 ”图 片 库 查 看 器 


@implementation TestBedViewController 
| 
PagedImageScrollView *scrollView; 
UIPageControl *pageControl; 


- (UIStatusBarStyle)preferredStatusBarStyle 


| 


return UlStatusBarStyleLightContent; 


- (void) loadView 

| 
self.view - [[UIView alloc] init]; 
self.view.backgroundColor = [UIColor blackColor]; 
self.navigationController.navigationBarHidden - YES; 


scrollView - [[PagedImageScrollView alloc] init]; 
scrollView.delegate = self; 
[self.view addSubview:scrollView]; 
PREPCONSTRAINTS (scrollView); 
ALIGN VIEW LEFT(self.view, scrollView); 
ALIGN VIEW RIGHT(self.view, scrollView); 
ALIGN VIEW TOP(self.view, scrollView); 
ALIGN VIEW BOTTOM(self.view, scrollView); 
scrollView.images = e[[UIImage imageNamed:@"bird"], 
[UIImage imageNamed:G"ladybug"], 
[UIImage imageNamed:@"flowers"], 
[UIImage imageNamed:G"sheep"]]; 


pageControl = [[UIPageControl alloc] init]; 
pageControl.numberOfPages - scrollView.images.count; 
pageControl.currentPage - 0; 
pageControl.pageIndicatorTintColor - [UIColor grayColor]; 
pageControl.currentPageIndicatorTintColor - 
[UIColor redColor]; 
[pageControl addTarget:self 
action:@selector (handlePageControlChange: ) 
forControlEvents:UIControlEventValueChanged] ; 
[self.view addSubview:pageControl]; 
PREPCONSTRAINTS (pageControl); 
ALIGN VIEW LEFT(self.view, pageControl); 
ALIGN VIEW RIGHT(self.view, pageControl); 
ALIGN VIEW BOTTOM CONSTANT(self.view, pageControl, -20); 


// Update the scrollView after page control interaction 
- (void)handlePageControlChange: (UIPageControl *)sender 


| 


CGFloat offset - 
scrollView.frame.size.width * pageControl.currentPage; 
[scrollView setContentOffset:CGPointMake(offset, 0) 
animated:YES]; 


// Update the page control after scrolling 
- (void)scrollViewDidEndDecelerating: (id)sender 


CGFloat distance - scrollView.contentOffset.x / 
scrollView.contentSize.width; 

NSInteger page - distance * pageControl.numberOfPages; 

pageControl.currentPage - page; 


| 


@end 


iOS 7 的 设计 风格 主要 围绕 着 内 容 而 展开 ， 所 以 对 UI 控件 修饰 得 稍微 少 了 一 些 。 这 个 图 片 库 查看 器 程序 完全 利用 了 屏幕 上 可 以 显示 内 容 的 区 域 ， 这 其 中 也 包括 状态 
栏 后 面 的 那 块 地 方 。iOS 7 的 状态 栏 已 经 不 再 支持 半 透 明 (translucent) 和 不 透明 (opaque) 这 两 种 风格 了 ， 现 在 只 支持 透明 风格 。iOS 提 供 了 两 种 样式 ， 供 开发 者 
在 显示 亮色 及 暗色 内 容 时 切换 状态 栏 的 样 狐 。 令 视图 控制 器 类 的 preferredStatusBarStyle 方 法 返回 一 种 UlStatusBarStyle， 即 可 改变 状态 栏 的 样式 。 


开发 者 可 以 根据 当前 所 显示 的 图 片 来 修改 状态 栏 的 风格 以 及 页 面 指 示 器 的 tint color， 使 控件 与 图 片 能 够 更 好 地 融合 起 来 。 修 改 时 所 参照 的 标准 可 以 是 图 片 的 平均 
颜色 ， 也 可 以 是 与 之 相似 的 其 他 量化 指标 。 这 项 高 级 功能 就 留 给 读者 当 作 练习 吧 。 


全 提示 “在 实现 UIScrollView 时 ， 想 通过 Auto Layout (自动 布局 ) 来 排 布 UI 元 件 是 相当 困难 的 。 革 果 公司 所 提供 的 《Technical Note TN2154》 开 发 文档 


(http: / /developer.apple.com/libraty /ios/**technotes/tn2154/ index.html) 描述 了 两 种 方式 。 解 决 方案 2-10 采 用 的 是 混合 方式 。 本 书 第 5 章 将 会 深入 讲解 Auto Layout. 


2.15 Jg TA 


只 要 编写 几 个 简单 的 宏 (macro) ， 我 们 就 可 以 用 代码 非常 方便 地 定义 并 排 布 工具 栏 了 。 下 面 这 几 个 宏 分 别 返回 4 种 样式 的 按钮 条 目 (button item) [1]， 如 果 需 
要 更 多 的 样式 ， 只 需 对 这 段 代 码 稍 加 改编 即 可 。 这 些 安 都 是 在 ARC (automatic reference couting， 自 动 引 用 计数 ) 环境 下 使 用 的 。 假 如 采用 手动 执行 retain 及 
release (manual retain-release， 简 称 MRR) 的 开发 方式 ， 那 么 请 记得 加 上 适当 的 autorelease 调 用 语句 : 


define BARBUTTON (TITLE, SELECTOR) [[UIBarButtonItem alloc] ^ 
initWithTitle:TITLE style:UIBarButtonItemStylePlain\ 
target:self action:SELECTOR] 

#define IMGBARBUTTON(IMAGE, SELECTOR) [[UIBarButtonItem alloc] \ 
initWithImage: IMAGE style:UIBarButtonItemStylePlain V 
target:self action:SELECTOR] 

#define SYSBARBUTTON(ITEM, SELECTOR) [[UIBarButtonItem alloc] "^ 
initWithBarButtonSystemItem:ITEM \ 
target:self action:SELECTOR] 

#define CUSTOMBARBUTTON (VIEW) [[UIBarButtonItem alloc} \ 
initWithCustomView: VIEW] 


以 上 分 别 表示 文本 (text) . EAR (image) . AZ (system) 及 自 定 义 视图 (custom view) 这 4 种 风格 的 button item。 每 个 安 都 提供 了 一 种 可 以 放 入 
UIToolbar 的 UIBarButtonltem。 程 序 清单 2-2 演 示 了 这 些 安 所 制作 的 按钮 效果 ， 大 家 可 以 看 到 每 一 种 风格 的 样 狐 ， 也 可 以 看 到 按钮 之 间 的 间隔 区 域 (spacer) . HA 
者 还 可 以 像 程序 清单 2-2 这 样 ， 在 工具 栏 上 添加 自 定 义 视图 。 在 本 例 中 ， 我 们 把 UlSwitch 实 例 当 成 button item 添 加 到 工具 栏 之 中 ， 效 果 如 图 2-11 所 示 。 


程序 清单 2-2 用 代码 创建 工具 栏 


@implementation TestBedViewController 
(void)action 


// no action actually happens 


- (void) loadView 


self.view = [[UIView alloc] init]; 
self.view.backgroundColor = [UIColor whiteColor]; 


- (void)viewDidLoad 


[super viewDidLoad] ; 

UIToolbar *tb = [UIToolbar alloc] init]; 
[self.view addSubview:tb] ; 

PREPCONSTRAINTS (tb) ; 

ALIGN VIEW BOTTOM(self.view, tb); 

ALIGN VIEW LEFT(self.view, tb); 

ALIGN VIEW RIGHT(self.view, tb); 

NSMutableArray *tbItems = [NSMutableArray array]; 


// Set up the items for the toolbar 
[tbItems addObject: 
BARBUTTON(G"Title", Gselector(action))]; 


[tbItems addObject: 
SYSBARBUTTON (UIBarButtonSystemItemFlexibleSpace, 
nil) i; 


[tbItems addObject: 
SYSBARBUTTON (UIBarButtonSystemItemAdd, 
@selector (action) )]; 


[tbItems addObject: 
SYSBARBUTTON (UIBarButtonSystemItemFlexibleSpace, 
nily]; 


[tbItems addObject: 
IMGBARBUTTON ( [UI Image imageNamed:@"star.png"], 
@selector (action))]; 


[tbItems addObject: 
SYSBARBUTTON (UIBarButtonSystemItemFlexibleSpace, 
nil)]; 


[tbItems addObject: 
CUSTOMBARBUTTON([[UISwitch alloc] init])]; 


[tbItems addObject: 
SYSBARBUTTON (UIBarButtonSystemItemFlexibleSpace, 
nil)]; 


[tbItems addObject: 
IMGBARBUTTON([UIImage imageNamed:G"moon.png"], 
@selector (action) )]; 


tb.items = tbItems; 


| 


@end 


Title T * . C 


图 2-11 工具 栏 上 的 button item 是 可 以 定制 的 ， 比 方 说 ， 我 们 可 以 把 开关 控件 添加 到 其 中 


除了 上 述 定义 的 这 四 个 安之 外 ， 只 有 一 种 button item 是 需要 由 开 友 者 手动 去 添加 的 ， 那 融 是 fixed-space (宽度 固定 的 间隔 区 域 ) 。 你 需要 设 定 这 个 item 的 
width 属性 ， 以 定义 它 所 占据 的 宽度 。 笔 者 最 后 总 结 了 设计 工具 栏 时 所 应 注意 的 几 个 问题 : 


Jic 


. 要 为 fixed space Etm]. 4 %4UlBarButtonltem? , Aj UlBarButtonSystem-ItemFixedSpace ix —#Pitem T VAIS VHF. MARAEA 3E Tspacerát AZA, MHRA 


设 定 其 宽度 ， 然 后 再 把 它 添加 到 保存 button item 的 数组 之 中 。 


- 用 一 个 宽度 可 变 的 间隔 区 域 来 实现 左 对 齐 或 右 对 亨 。 如 果 在 item 列 表 的 开头 添加 一 个 UIBarButtonSystemItemFlexibleSpace， 那 么 其 余 的 item 就 会 右 对 齐 。 若 添加 到 


众 item 尾 部 ， 则 其 余 的 item 就 会 左 对 齐 。 要 是 头 尾 各 添加 一 个 ， 那 么 剩 下 的 item 就 会 居中 。 


: 要 处 理 好 消失 的 button item。 有 时 我 们 要 根据 程序 的 状况 来 隐藏 某 个 button item， 假 如 没有 使 用 布局 限制 ， 那 么 请 勿 通过 UIBarButtonSystemItemFlexibleSpace 来 
隐藏 item。 此 时 我 们 应 该 把 待 隐 藏 的 item 替 换 成 尺寸 与 之 相同 的 固定 宽度 的 间隔 区 域 。 这 样 做 既 可 以 保留 原 有 布局 ， 又 能 使 其 他 图 标的 位 置 在 item 消 失 之 前 与 消失 之 后 
保持 不 变 。 


- 导航 栏 上 面 也 可 以 有 多 个 button item。 开 发 者 可 以 向 导航 栏 及 其 UINavigationItem 对 象 添加 button item 数 组 。 我 们 可 以 把 button item 数 组 添加 到 UINavigationItem 
里 (例如 ，self.navigationItem.rightBarButtonItems 二 anAtray) ， 而 不 是 像 平常 那样 只 添加 单个 button item， 这 样 一 来 ， 就 可 以 实现 出 类 似 工 具 栏 的 效果 了 。 在 构建 工具 栏 
时 ， 我 们 可 以 指定 UIBarButtonItem 的 提示 (hint) ， 也 可 以 通过 宽度 可 变 的 间隔 区 域 来 调整 各 button item 的 布局 ， 而 在 构建 导航 栏 及 其 UINavigationItem 时 ， 这 些 布 局 手 
段 同样 有 效 。 


1] 为 了 与 UIButton 这 种 普通 的 按钮 控件 相 区 别 ， 工 具 栏 上 的 按钮 状 图 形 称 作 button item。 在 不 引起 混淆 的 情况 下 ， 译 文 酌情 将 其 译 为 “按钮 ”， 或 保留 button item% 
译 者 注 


item 英 文 原 样 o 


2.16 ”小 结 


本 章 介绍 了 多 种 交互 方式 ， 读 者 学 到 了 如 何 利用 控件 来 尽量 提升 应 用 程序 的 交互 能 力 。 在 开始 学 习 下 一 章 之 前 ， 大 家 可 以 先 回 顾 下 列 问题 : 


. 不 要 只 把 控件 当成 UIControl 类 来 看 待 ， 而 是 要 记得 ， 它 其 实 也 是 个 UIView。 我 们 可 以 为 其 添加 子 视图 、 对 其 尺寸 进行 缩放 、 给 它 指定 动画 效果 、 使 它 在 屏幕 上 
移动 或 是 为 其 贴 上 标签 ， 以 备 后 用 。 


* 开发 者 可 以 通过 Core Graphics A Quartz 2D 来 构建 视觉 元 件 。 只 需 在 SDK 所 提供 的 类 上 稍微 添加 一 些 醒目 的 实时 演算 效果 ， 即 可 令 控 件 更 加 美观 。 


. 开发 者 可 以 通过 UIKit 中 的 相关 方法 ， 利 用 NSDictionary 来 配置 带 属性 的 字符 串 ， 并 据 此 指定 控件 文本 的 特征 。 你 可 以 选择 符合 自己 设计 风格 的 字体 、 线 条 样式 、 
段落 样式 、 颜 色 和 阴影 效果 等 。 


` 如 果 iOS SDK 没 有 提供 你 所 需 的 控件 ， 那 么 可 以 根据 既 有 控件 来 改编 ， 也 可 以 从 头 构建 一 种 新 的 控件 。 


- 革 果 公司 自己 的 UI 设 计 风 格 是 非常 精良 的 。 创 建新 的 交互 方式 时 ， 不 妨 参 考 一 下 革 果 公司 现 有 的 样 例 ， 比 方 说 ， 如 果 我 们 要 在 执行 删除 操作 之 前 向 用 户 提 供 一 
个 确认 按钮 ， 可 以 参照 苹果 公司 的 做 法 来 设计 。 


. 创建 程序 界面 时 ，IB 并 不 一 定 是 最 好 用 的 方式 。 比 方 说 ， 我 们 可 以 直接 在 Xcode 里 编写 代码 ， 并 以 此 构建 工具 栏 ， 这 么 做 要 比 在 IB 里 面 手工 调整 每 个 元 件 更 省 时 
间 。 


3m ”提醒 用 户 


有 时 ， 程 序 需要 吸引 用 户 注意 。 比 方 癌 ， 当 程序 要 获取 新 数据 或 要 改变 状态 时 融 是 如 此 。 有 些 情况 下 ， 我 们 要 在 事情 友 生 之 前 先 提醒 用 户 等 待 一 段 时 间 ; 而 有 些 
情况 下 ， 则 要 在 等 待 结束 之 后 提醒 用 户 ， 现 在 可 以 回来 操作 程序 了 。iOS 提 供 了 许多 种 向 用 户 展示 信息 的 方式 ， 例 如 警示 窗 、 进 度 条 、 提 示 音 等 。 本 章 要 告诉 大 家 如 何 
来 实现 这 些 提示 功能 ， 令 读者 能 够 以 更 多 的 方式 提醒 用 户 。 你 会 看 到 一 些 实用 的 范例 ， 而 通过 这 些 与 提示 功能 有 关 的 类 ， 我 们 可 以 明日 怎样 在 适当 的 时 机 吸引 用 户 的 
注意 力 。 


31 直接 向 用 户 弹出 警告 视图 


开 上 友 者 可 以 通过 警告 视图 (Alert View) 来 告诉 用 户 一 些 事 情 。 我 们 可 以 在 程序 中 弹出 UIAlertView， 也 可 以 把 UIActionSheet 显 示 在 其 他 视图 上 面 ， 以 此 来 告知 
用 户 相 关 的 消息 。 这 些 轻 量 级 的 类 可 用 来 在 程序 中 添加 双向 对 话 框 。 警 告 视图 能 够 以 视觉 信息 的 形式 对 用 户 “ 说 话 ”， 并 提醒 用 户 答复 它们 。 开 发 者 向 用 户 展示 警告 
视图 ， 在 得 到 用 户 确认 之 后 ， 将 其 隐藏 起 来 ， 并 继续 处 理 其 他 任务 。 


你 认为 警告 视图 仅仅 是 一 段 信息 加 上 一 个 OK 按钮 吗 ? 请 再 好 好 想 想 。 其 实 ，UIAlertView 对 象 的 用 法 十 分 丰富 。 比 方 说 ， 我 们 可 以 用 它 来 构建 进度 指示 器 ， 用 它 
来 输入 文本 ， 也 可 以 通过 它 进行 查询 。 本 章 的 各 条 解决 方案 将 会 展示 许多 种 实用 的 警告 视图 ， 有 一 些 是 系统 提供 的 ， 还 有 一 些 是 笔者 自己 定义 的 ， 它 们 都 能 够 用 在 你 
目 己 的 程序 中 。 


3.1.1 构建 简单 的 警告 视图 
想 要 构建 警告 视 图 ， 可 以 先 分 配 UIAlertView 对 稼 ， 然 后 用 一 条 标题 以 及 一 个 包含 按钮 标题 的 数组 来 初始 化 它 。 与 按钮 的 标题 一 样 ，UIAlertView 的 标题 也 是 个 
NSString。 而 按钮 数组 中 的 每 个 字符 串 则 分 别 表示 应 该 显示 在 UlAlertView 之 中 的 各 个 按钮。 


下 面 这 个 方法 的 代码 用 来 创建 并 显示 最 为 简单 的 警告 视图 ， 它 是 一 条 标题 加 上 一 个 OK 按钮 。 这 个 警告 视图 没有 委托 及 回调 ， 所 以 ， 当 用 户 点 击 按钮 之 后 ， 它 的 生 
命 期 就 终结 了 : 


- (void)showAlert: (NSString *)theMessage 


| 
UIAlertView *av = [[UIAlertView alloc] initWithTitle:@"Title" 
message:theMessage 
delegate:nil 
cancelButtonTitle:G"OK" 
otherButtonTitles:nil]; 
[av show]; 


如 果 还 想 加 入 其 他 按钮 ， 那 么 就 通过 otherButtonTitles: 参数 将 其 传 入 。 请 注意 ， 在 传 给 该 参数 的 那 一 系列 按钮 的 最 后 ， 必 须 有 个 nil。 这 个 nil 会 告诉 
initWithTitle 方 法 按钮 已 经 指定 完了 。 接 下 来 这 个 方法 会 创建 一 种 包含 三 个 按钮 的 警告 视图 ， 这 三 个 按钮 分 别 是 : Cancel、Option 以 及 OK。 由 于 下 面 这 段 代 码 也 没有 
虽 明 委托 ， 所 以 我 们 没有 办 法 在 稍 后 使 用 这 个 警告 视图 ， 也 无 法 判断 用 户 到 底 点 击 了 哪个 按钮 。 它 只 会 把 警告 视图 显示 出 来 ， 等 用 户 点 击 某 个 按钮 之 后 ， 窗 口 就 会 消 
失 ， 而 且 不 会 有 其 他 效果 : 


- (void)showAlert: (NSString *)theMessage 


{ 
UIAlertView *av = [[UIAlertView alloc] initWithTitle:@"Title" 
message : theMessage 
delegate:nil 
cancelButtonTitle:@"Cancel" 
otherButtonTitles:G"Option", @"OK", nil]; 
[av show]; 


在 编写 警告 视图 的 时 候 ， 一 定 要 利用 好 窗口 空间 。 如 果 添 加 的 按钮 多 于 两 个 ， 那 么 系统 就 会 以 多 行 模式 来 显示 。 图 3-1 演 示 了 两 种 警告 视图 ， 一 种 是 两 个 按钮 并 排 
摆 放 ， 另 一 种 是 三 个 按钮 从 上 到 下 摆 放 。 无 论 何 时 ， 都 不 要 给 警告 视图 添加 三 四 个 以 上 的 按钮 。 按 钮 越 少 ， 效 果 越 好 。 一 到 两 个 是 最 理想 的 。 如 果 想 使 用 更 多 按钮 ， 
那么 请 考虑 改 用 UIActionSheet 对 象 而 不 是 UIAlertView 来 实现 ， 本 章 稍 后 将 会 讨论 UIActionSheet。 


UlAlertView 对 象 提 供 了 一 套 人 简单 的 高 亮 机 制 ， 可 以 突出 显示 窗口 中 的 默认 (default) 按钮 。 由 图 3-1 可 以 看 出 ， 哪 个 按钮 呈现 高 党 与 窗口 中 的 按钮 个 数 有 关 。 如 
果 只 有 两 个 按钮 ， 那 么 右 侧 的 按钮 呈现 高 亮 。 也 就 是 说 ， 在 初始 化 这 种 警告 视图 的 时 候 ， 传 给 otherButtonTitles 的 那个 按钮 会 呈现 高 亮 。 如 果 按 钮 超过 两 个 ， 那 么 最 
底部 的 按钮 呈现 高 之 。 一 般 来 说 ， 此 按钮 束 是 开发 者 传 给 cancelButtonTitle 参 数 的 那个 按钮 。 假 如 没有 提供 该 参数 ， 那 么 otherButtonTitles 中 的 最 后 一 个 按钮 束 充 当 
默认 按钮 。 总 之 ， 传 给 cancelButtonTitle 的 那个 按钮 会 出 现在 窗口 底部 或 左 侧 。 
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Test Alert OK 


图 3-1 有 一 到 两 个 按钮 时 ，UIAletrtView 的 显示 效果 最 好 (如 左 图 所 示 ) . wWRRAS TAR, MARARARNAM-PHSRA, X6mp) XGRGDORGUTGRASPT 
(如 右 图 所 示 ) 


3.1.2 ”设置 UlAlertView 的 委托 


开发 者 如 何 才能 知道 用 户 点 了 OK 或 Cancel 按 钮 呢 ? 通 过 UlAlertView 的 委托 ， 我 们 可 以 在 用 户 做 出 选择 之 后 ， 于 一 个 简单 的 回调 方法 中 得 知 此 信息 。 委 托 应 该 遵 


从 UIAlertViewDelegate 协 议 。 一 般 情 况 下 ， 我 们 会 把 主要 的 (也 就 是 活动 的 ) 视图 控制 器 对 象 设 为 警告 视图 的 委托 。 
通过 委托 中 的 一 些 方法 ， 我 们 可 以 响应 用 户 的 点 击 操作 。 正 如 前 一 节 所 示 ， 假 如 只 需 显 示 一 段 带 有 OK 按钮 的 信息 ， 那 么 可 以 不 设置 委托 。 


用 户 操作 完 警 告 视 图 之 后 ， 委 托 就 会 收 到 名 为 alertView: clickedButtonAtIndex: 的 回调 。 系 统 传 给 这 个 方法 的 第 二 个 参数 就 表示 用 户 所 点 击 的 按钮 。 按 钮 编号 
从 0 开始 ，Cancel 按 钮 默认 是 0 号 按钮 。 在 有 的 窗口 中 ，Cancel 按 钮 位 于 左 侧 ， 而 在 有 的 窗口 中 ， 它 则 位 于 底部 ， 虽 说 如 此 ， 但 其 编号 却 是 一 样 的 ， 除 非 开 发 者 自己 调 
整 了 Cancel 按 钮 的 索引 (可 以 通过 cancelButtonlndex 属 性 来 操作 ) 。UIActionSheet 对 象 的 情况 与 UIAlertView 不 同 ， 本 章 稍 后 讨论 这 个 问题 。 


下 面 这 段 范 例 代 码 会 显示 出 一 种 市 回调 的 和 耀 告 视图 ， 我 们 在 回调 方法 中 ， 把 用 户 所 点 击 的 按钮 编号 打印 到 调试 用 的 控制 台 里 : 


@interface TestBedViewController : UIViewController 
<UIAlertViewDelegate> 
@end 


@implementation TestBedViewController 
- (void)alertView: (UIAlertView *)alertView 
clickedButtonAt Index: (int) index 


NSLog(@"User selected button %d\n", index) ; 


| 


- (void)showAlert 


| 


UIAlertView *av = [[UIAlertView alloc] 
initWithTitle:@"Alert View Sample" 
message:@"Select a Button" 
delegate:self 


cancelButtonTitle:@"Cancel" 
otherButtonTitles:@"One", @"Two", @"Three", nil]; 


// Tag your UIAlertView so it can be distinguished 
// from others in your delegate callbacks. 

av.tag = MAIN ALERT; 

[av show]; 


| 


@end 


如 果 控 制 器 要 控制 多 个 UIAlertView， 那 么 在 回调 方法 中 ， 我 们 可 以 通过 标 等 来 辨别 不 同 的 UIAlertView。 与 控件 所 用 的 目标 -动作 机 制 不 同 ， 所 有 的 UIAlertView 
都 会 触 友 同 一 种 回调 方法 。 于 是 ， 开 友 者 可 以 根据 标签 ， 在 switch 语 句 里 面 针 对 不 同 的 UlAlertView 分 别 进行 响应 。 


3.1.3 ”显示 UlAlertView 


show 这 个 实例 方法 可 以 把 UIAlertView 显 示 出 来 。 而 显示 出 来 之 后 ， 警 告 视图 融会 呈现 模 态 (modal) 。 也 就是 说 ， 它 后 面 的 屏幕 内 容 会 变 瞳 ， 同 时 ， 用 户 无 法 
操作 程序 里 面 除 UIAlertView 之 外 的 部 分 。 等 用 户 通 过 点 击 某 个 按钮 (通常 是 OK 或 Cancel) 对 UIAlertView 做 出 确认 之 后 ， 这 个 模 态 视图 就 消失 了 。 此 时 ， 系 统 会 把 控 
制 权 交 给 UIAlertView 的 委托 ， 使 开 友 者 可 以 在 其 中 完成 收尾 工作 ， 并 对 用 户 所 选 的 按钮 做 出 响应 。 


UlAlertView 的 各 项 属性 在 创建 之 后 依然 可 以 修改 。 你 可 通过 修改 title 或 message 属 性 来 定制 已 。message 是 一 段 可 选 的 文本 ， 它 会 出 现在 UlAlertView 的 title 之 
下 、 按 钮 之 上 。 经 由 addButtonWithTitle: 方法 ， 还 可 以 再 添加 一 些 按钮 。 


3.1.4 各 种 UIAlertView 


开 友 者 可 以 通过 alertViewstyle 属 性 创建 不 同样 式 的 UIAlertView。 按 默认 样式 (也 就 是 UlAlertViewStyleDefault) 创建 出 来 的 UIAlertView 具 备 标 题 及 信息 文 
本 ， 另 外 还 可 以 有 一 些 按钮 ， 其 效果 如 图 3-1 所 示 。 这 是 UlAlertView 系 列 中 的 基本 款式 ， 开 发 者 能 够 由 此 征询 用 户 的 意见 ， 而 用 户 则 可 以 通过 点 击 Yes/No、 
Cancel/OK 等 按钮 做 出 简单 的 选择 。 


iOS 还 提供 了 三 种 样式 ， 它 们 专门 针对 需要 输入 文本 的 场合 : 


- UIAlertViewstylePlainTextlnput 一 一 用 户 可 以 在 这 种 样式 的 UIAlertView 里 输入 文本 。 


- UIAlertViewsStyleSecureTextlnput 一 一 假如 要 考虑 安全 问题 ， 那 么 可 以 采用 这 种 样式 的 UIAlertView， 它 会 把 用 户 键入 的 文本 自动 遮盖 起 来 。 文 本 将 会 以 一 系列 
大 圆 点 的 形式 来 显示 ， 而 开发 者 则 可 以 在 委托 的 回调 方法 中 编写 代码 ， 读 取 用 户 输入 的 内 容 。 


该 样式 的 UIAlertView 提 供 了 两 个 文本 框 供 用 户 输入 ， 一 个 是 login 〈 登 录 ) 文本 框 ， 用 于 输入 明文 的 用 户 账 号 ， 


- UlAlertViewStyleLoginAndPasswordlnput 
另 一 个 是 passwotd (密码 ) 文本 框 ， 用 于 输入 密码 ， 系 统 会 把 密码 掩藏 起 来 。 


如 果 要 给 UIAlertView 添 加 文本 输入 功能 ， 融 把 按钮 设计 得 简单 一 些 。 最 多 用 两 个 并 排 摆 放 的 按钮 ， 一 般 是 OK 及 Cancel 近 钮 。 要 是 再 增加 按钮 的 话 ， 融 不 太美 观 
， 会 令 文 本 框 漂浮 在 UIAlertView 上 方 ， 或 出 现在 其 两 侧 。 


对 于 UIAlertView 来 说 ， 开 发 者 可 以 查看 用 户 在 每 个 文本 框 中 输入 的 文本 。textField-Atindex: 方法 接受 一 个 参数 ， 此 参数 是 个 从 0 开始 的 索引 ， 而 返回 值 则 是 处 
在 该 索引 位 置 上 的 文本 框 。 在 实际 的 开发 中 ， 除 了 password 文 本 框 的 索引 是 1 之 外 ， 其 他 文本 框 使 用 的 索引 都 是 0。 获 取 到 文本 框 之 后 ， 就 可 以 像 下 面 这 样 通过 text 局 
性 查询 其 内 容 了 : 


NSLog (@"%@", [myAlert textFieldAtIndex:0].text); 


32 ”解决 方案 : 构建 支持 块 的 警告 视图 


UlAlertView 的 委托 回调 机 制 可 能 会 导致 开发 者 必须 编写 比较 复杂 的 代码 才 行 。 所 有 的 处 理 代 码 都 遵循 同一 个 套路 ， 而 我 们 在 回调 方法 里 必须 通过 标签 来 区 分 想 要 
处 理 的 各 种 UlAlertView。 此 外 ， 为 了 制作 出 图 3-2 这 样 的 UlAlertView， 还 必须 将 按钮 及 其 对 应 功能 小 心地 设置 好 。 


What is your name? 
Please enter your name below 


Cancel 
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图 3-2 ”这 种 警告 视图 没有 使 用 UIAlertView 类 里 传统 的 回调 机 制 ， 而 是 通过 开发 者 在 创建 按钮 时 所 指定 的 块 来 响应 用 户 的 操作 


有 个 办 法 要 比 使 用 委托 回调 简单 得 多 ， 那 束 是 在 声明 按钮 的 时 人 息 ， 和 直接 把 所 要 执行 的 实现 代码 传 进去 。 这 项 任务 正 适 合用 块 来 完成 。 


3.2.1 HEN 


块 是 对 C 语 言 的 一 种 扩展 ，iOS 4 首次 将 其 引入 。 它 在 概念 上 与 方法 或 函数 类 似 ， 而 且 可 以 保 仓 到 变量 里 面 。C 语 言 中 有 一 套 类 似 的 机 制 用 来 保存 尔 数 ， 那 融 是 函数 
指针 。 然 而 块 不 仅 仪 是 函数 据 针 ， 它 不 但 能 保存 其 中 的 可 执行 代码 ， 而 且 还 能 把 外 围 作 用 域 拷贝 一 份 并 保存 起 来 。 


定义 块 的 时 候 ， 系 统 会 创建 一 份 局 部 栈 的 拷贝 ， 并 将 其 与 块 天 联 起 来 。 等 程序 真正 开始 执行 块 时 ， 它 就 能 访问 这 份 拷贝 出 来 的 栈 了 。 这 项 功能 非常 强大 ， 使 得 开 
发 者 可 以 把 一 段 代码 及 其 周边 状态 包 于 到 块 里 面 ， 并 传 给 某 个 方法 。 而 那 段 代码 则 能 在 将 来 某 个 时 间 点 或 某 种 特定 的 环境 下 执行 ， 比 方 说 ， 可 以 在 另外 一 个 线程 中 执 
行 ， 也 可 以 按 某 种 特定 的 次 序 来 执行 。 

块 的 语法 稍微 有 后 复杂 。 它 在 某 些 方面 与 C 语 言 的 消 数 所 针 相似 ， 所 以 ， 不 熟悉 函数 拭 针 的 开 友 者 也 许 会 党 得 块 看 上 去 有 些 奇怪 。 块 的 代码 是 以 插入 符 〈^) RR 
示 的 。 一 般 来 说 ， 块 包含 返回 值 类 型 、 参 数列 表 以 及 代码 块 本 身 : 


“(return type) (argument list) { // code block ) 
返回 值 的 类 型 若是 void， 则 可 以 省 略 。 假 如 根本 就 没有 参数 ， 那 么 可 以 把 整个 参数 列表 都 省 略 掉 。 我 们 可 以 像 下 面 这 样 来 定义 最 简单 的 块 : 
^{ // your code here } 
如 果 想 针对 某 个 块 编写 typedef 语 句 ， 那 么 代码 的 写法 会 与 上 面 列 出 的 块 的 通行 写法 稍 有 区 别 |: 
typedef (return type) (“typeName) (argument list); 


定义 好 块 之 后 ， 束 可 以 像 下 面 这 样 执行 它 了 : 


typedef void (^SomeBlock) (BOOL); 
SomeBlock myBlock - ^(BOOL success) 
| 
if (success) 
NSLog (@"Successful!") ; 
else 
NSLog (@"FAILED!") ; 
bs 


myBlock (YES); 


上 面 这 段 代码 与 普通 的 方法 调用 相 比 并 没有 什么 特别 之 处 。 不 过 ， 当 我 们 把 块 当成 参数 传 给 万 法 的 时 候 ， 它 的 用 法 就 变 得 丰富 多 了 ， 比 方 说 ， 在 遍历 数组 时 ， 可 
以 针对 其 中 每 个 元 素来 执行 块 。 另 外 ， 块 还 有 一 项 特性 ， 融 是 能 够 访问 外 围 作用 域 中 的 变量 。 下 面 这 段 学 例 代 码 可 以 访问 捕获 到 的 myBaseNumber: 


NSInteger myBaseNumber = 7; 
NSArray *numbers = @[@2, 93, @5, @8, @9, 011]; 


[numbers enumerateObjectsUsingBlock:^(id obj, NSUInteger idx, BOOL *stop) 


f 


\ 
NSInteger current = [obj integerValue] ; 


NSLog(@"sd * td = %d", myBaseNumber, current, myBaseNumber * current); 
el ee 


} , 


即便 离开 了 变量 所 处 的 作用 域 ， 块 也 依然 能 够 访问 捕获 到 的 上 下 文 [1。 


捕获 外 围 作用 域 这 样 的 特性 有 时 可 能 会 产生 一 些 问题 。 由 于 块 所 存储 的 栈 只 是 一 份 拷贝 ， 所 以 ,假如 有 人 在 定义 了 块 之 后 ， 还 未 等 它 执行 就 先 去 修改 捕获 到 的 变 
量 ， 那 么 到 了 真正 运行 块 的 时 人 息 ， 就 无 法 看 到 修改 后 的 值 了 。 另 外 ， 开 发 者 若是 在 块 范 围 内 对 捕获 到 的 变量 进行 修改 ， 那 么 出 了 块 学 围 之 后 ， 所 做 的 变更 就 会 丢失 。 


如 果 想 在 块 范围 内 修改 某 个 捕获 到 的 变量 ， 那 么 声明 该 变量 时 ， 必 须 加 上 _ block 这 个 存储 类 型 修饰 符 。 加 上 _block 之 后 ， 变 量 就 会 放 在 一 份 共 享 的 存储 区 里 面 ， 
这 使 得 原始 代码 的 外 围 作 用 域 以 及 块 都 可 以 去 访问 它 。 


还 有 个 问题 也 和 块 及 捕获 到 的 作用 域 相 关 ， 那 就 是 保留 循环 (retain cycle) 2, 


[1] context 通 译 “ 上 下 文 ”， 此 处 可 以 理解 为 “程序 的 执行 环境 中 的 内 容 ”。 译 者 注 
[2] 通 译 “循环 引用 ”。 它 是 由 tetain (保留 ) 操作 而 导致 的 引用 循环 ， 故 而 也 可 称 为 保留 循环 。 为 了 保持 循环 引用 这 一 中 文 术 语 同 citcular reference 这 一 英文 术语 之 间 的 


对 应 关系 ， 译 文 将 retain cycle 照 原样 写 出 。 译 者 注 


3.2.2 ”使 用 块 时 避免 保留 循环 


使 用 块 时 ， 要 小 心 别 出 现 了 保留 循环 。 开 发 者 经 常 无 意 间 在 块 里 面 对 self 进 行 了 保留 。 这 可 能 是 直接 由 引用 self 造 成 的 ， 也 可 能 是 由 于 使 用 ivarl1j 而 导致 的 ， 因 为 
ivar 会 间接 地 捕获 self。 


为 了 避免 保留 循环 ， 我 们 可 以 捕获 弱 引 用 版 本 的 self， 并 将 这 个 弱 引 用 赋 给 某 个 强 引 用 ， 然 后 再 于 块 里 使 用 它 。 我 们 可 以 在 块 的 开头 声明 这 个 强 引 用 ， 这 样 的 话 ， 
它 就 能 够 在 整个 块 范围 内 保持 有 效 了 。 别 忘 了 检查 这 个 指向 self 的 强 引 用 是 不 是 nil。 下 面 这 段 代 码 既 不 会 产生 保留 循环 ， 又 不 会 出 现 引 用 nil 的 问题 : 
. weak TestBedViewController *weakSelf = self; 
[blockAlertView addButtonWithTitle:G"OK" actionBlock:^[ 
TestBedViewController *strongSelf = weakSelf; 
if (strongSelf) 
{ 
NSString *name = [strongSelf->blockAlertView 


textFieldAtIndex:0].text; 
NSLog(e"Tapped OK after entering: %@", name); 


1); 


通过 使 用 块 ， 我 们 可 以 写 出 更 为 清晰 的 API， 而 且 ， 它 还 能 极 大 地 简化 多 线程 环境 下 的 编程 。 本 节 只 打算 稍微 谈 一 谈 块 的 功能 及 用 法 。 苹 果 公 司 的 开发 文档 里 有 非 
常 详尽 的 信息 ， 用 来 描述 块 及 Grand Central Dispatch (简称 GCD) ， 那 些 内 容 值得 一 读 。 


Qi 在 实现 并 行 任务 处 理 的 时 候 ，Grand Central Dispatch (GCD) 是 个 非常 强大 的 工具 。iOS 从 第 4 版 开始 引入 了 GCD 这 个 工具 ， 它 提供 了 一 套 基 于 函数 的 


API， 并 利用 块 机 制 来 构建 并 发 代码 (concurrent code) ， 以 发 挥 多 核 硬件 的 优势 。 


大 部 分 苹果 公司 程序 库 都 已 经 完全 同 块 集成 好 了 ， 不 过 还 是 有 一 些 类 没 经 过 改装 。 比 方 说，UIAlertView 融 驭 需 添加 对 块 的 文 持 。 学 会 使 用 块 忆 后 ， 你 会 友 现 它们 
还 有 好 多 种 用 法 。 


解决 方案 3-1 扩 充 了 标准 的 UlAlertView 类 ， 令 开 友 者 可 以 在 创建 按钮 时 指定 块 ， 从 而 减少 代码 的 复杂 程度 ， 并 使 得 响应 用 户 操 作 的 代码 能 够 离 声 明 按钮 的 代码 近 
一 些 。 有 了 这 个 类 之 后 ,我 们 就 不 用 实现 委托 或 委托 回调 了 。 


时 说 本 条 解决 方案 中 并 未 出 现 UIAlertView 类 里 原 有 的 一 些 委 托 方 法 ， 但 只 需 稍微 编写 几 行 代码 ， 融 可 以 继续 使 用 它们 。setDelegate 方 法 会 把 委托 保存 到 
externalDelegate 里 面 ， 以 供 开 发 者 使 用 。 我 们 可 以 给 BlockAlertView 添 加 代理 (proxy) 方法 ， 把 系统 对 UlAlertView 的 委托 所 做 的 调用 转发 给 externalDelegate: 


- (void)didPresentAlertView: (UIAlertView *)alertView 


| 


if ([externalDelegate 
respondsToSelector:Gselector(didPresentAlertView:)]) 


[excernalDelegate didPresentAlertView:alertView]; 


\ 一 /一 


当 用 户 点 击 警 告 视图 中 的 某 个 按钮 时 ，BlockAlertView 会 执行 与 该 按钮 相关 的 块 。 另 外 还 可 以 再 做 一 项 改进 ， 令 开 友 者 能 够 更 精细 地 控制 块 的 运行 时 机 。 这 项 改 
进 留 给 读者 作为 练习 。 目 前 这 个 类 会 在 UIAlertView 中 名 为 alertView: clickedButtonAtindex: 的 委托 回调 方法 里 面 执行 块 。 这 种 做 法 也 许 没什么 问题 ， 不 过 有 的 开 
发 者 可 能 想 等 警告 视图 的 消失 动画 彻底 播放 完 之 后 再 去 执行 块 。 你 可 以 给 BlockAlertView 添 加 一 个 简单 的 布尔 属性 ， 令 其 根据 该 属性 来 决定 应 该 在 哪 一 个 委托 回调 方 


BET RE 


法 里 面 执行 块 。 


解决 方案 3-1 “创建 基于 块 的 警告 视图 


@implementation BlockAlertView 


| 


| weak id <UIAlertViewDelegate> externalDelegate; 
NSMutableDictionary *actionBlocks; 


- (instancetype)init 
{ 
self = [super init]; 
if (self) 
| 
self.delegate - self; 
actionBlocks - [[NSMutableDictionary alloc] init]; 


| 


return self; 
- (instancetype)initWithTitle: (NSString *)title 
message: (NSString *)message 
return [super initWithTitle:title 


message:message delegate:self cancelButtonTitle:nil 
otherButtonTitles:nil]; 


// Add cancel button to alert with title and block 


- (NSInteger)setCancelButtonWithTitle: (NSString *)title 
actionBlock: (AlertViewBlock) block 


if (ftitle) return -1; 

NSInteger index - [self addButtonWithTitle:title 
actionBlock:block]; 

self.cancelButtonIndex - index; 

return index; 


// Add button to alert with title and block 
- (NSInteger)addButtonWithTitle: (NSString *)title 
actionBlock: (AlertViewBlock)block 


if (!title) return -1; 
NSInteger index - [self addButtonWithTitle:title]; 
if (block) 


{ 


// Copy moves blocks from stack to heap 
actionBlocks [@(index)] = [block copy]; 


j 


return index; 


- (id«UIAlertViewDelegate»)delegate 


{ 


return externalDelegate; 


// If the delegate is self, set on super, otherwise store 
// £or possible future use to proxy delegate methods. 
- (void) setDelegate: (id)delegate 


{ 


if (delegate == nil) 


{ 


[super setDelegate:nil] ; 
externalDelegate = nil; 


} 


else if (delegate == self) 


| 


[super setDelegate:self]; 


} 


else 


{ 


externalDelegate = delegate; 


#pragma mark - UIAlertViewDelegate 


// Execute the appropriate actionBlock. 


// View will be automatically dismissed after this call returns 
- (void)alertView: (UIAlertView *)alertView 
clickedButtonAtIndex: (NSInteger)buttonIndex 


AlertViewBlock actionBlock = actionBlocks [0 (buttonIndex)]; 
if (actionBlock) 


| 


actionBlock(); 


| 


@end 


获取 解决 方案 代码 


访问 https://github.com/erica/iOS-7-Cookbook 网 页 ， 并 打开 “C03Alerts” 文 件 夹 ， 即 可 找到 与 本 章 中 的 解决 方案 相对 应 的 完整 范例 项 目 。 


[1] 是 instance variable (实例 变量 ) 的 简称 。 


译 者 注 


3.3 ”解决 方案 : 将 变 长 参数 列表 与 UIAlertView 结 合 起 来 使 用 


有 些 方 法 的 参数 个 数 可 以 变化 ， 这 种 方法 叫 作 variadic 方 法 。 开 发 者 可 以 在 最 后 一 个 普通 参数 后 面 使 用 省 略 号 
(http://www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15137/OEBPS/Text/...) 来 声明 变 长 参数 列表 (Variadic 
Argument) 。NSLog 与 printf 都 是 参数 个 数 可 变 的 方法 。 你 可 以 向 其 传 入 格式 化 字符 串 ， 并 同时 传 入 任意 数量 的 其 他 参数 。 


由 于 大 部 分 警告 视图 都 注重 于 显示 文本 ， 所 以 我 们 可 以 提供 一 些 方法 ， 使 开 友 者 能 够 用 格式 化 字符 串 轻松 地 创建 出 UIAlertView。 解 决 方案 3-2 创 建 的 say: 方法 可 
以 把 开发 者 传 给 它 的 参数 收集 起 来 ， 并 据 此 构建 字符 串 。 然 后 ， 它 会 把 字符 串 传 给 UIAlertView， 并 将 其 显示 出 来 。 通 过 这 个 简单 的 方法 ， 可 以 迅速 把 警告 视图 显示 到 
屏幕 上 。 


say: 方法 既 不 解析 变 长 参数 列表 ， 也 不 会 去 分 析 它 们 ， 而 是 直接 把 第 一 个 参数 当成 格式 化 字符 串 ， 并 与 其 他 参数 一 起 ， 传 给 NSstring 的 initWithFormat: 
arguments: 方法 。 这 样 就 构建 好 了 字符 串 ， 然 后 ，say: 方法 会 把 字符 串 作 为 标题 (title) 传 给 initWithTitle 方 法 ， 以 制作 只 含 一 个 按钮 的 UIAlertView。 


本 来 我 们 要 先 用 格式 化 字符 串 创建 NSstring， 然 后 再 调用 initWithTitle 方 法 来 创建 UIAlertView， 但 定义 了 参数 个 数 可 变 的 工具 方法 之 后 ， 就 可 以 省 略 这 些 步 又 
了 。 现 在 只 需 调用 say: 方法 ， 就 可 以 完成 上 述 步骤 : 


[NotificationAlert say: 


@"I am so happy to meet you, %@", yourName]; 
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解决 方案 3-2 ”用 参数 个 数 可 变 的 方法 来 简化 UIAlertView 的 创建 


+ (void)say: (id)formatstring,... 


| 


if (!formatstring) return; 


va list arglist; 

va startí(arglist, formatstring); 

id statement - [[NSString alloc] 
initWithFormat:formatstring arguments:arglist] ; 


va_end(arglist) ; 


UIAlertView *av = [[UIAlertView alloc] 
initWithTitle:statement message:nil 
delegate:nil cancelButtonTitle:G"Okay" 
otherButtonTitles:nil]; 

[av show]; 


3.4 ”展示 选项 列表 


UIActionSheet 实 例 可 以 创建 简单 的 OS 菜单 。 在 iPhone 及 iPod touch 上 面 ， 这 种 菜单 会 把 各 个 选项 展示 a 到 屏幕 上 ， 并 等 竺 用 户 做 出 选择 ， 而 那些 选项 基本 上 整 
是 一 系列 表示 相关 操作 的 按钮 。 在 iPad 上 面 ， 它 们 是 以 弹出 框 (popover) 形式 呈现 的 ， 并 且 其 中 没有 Cancel 按 钮 。 用 户 在 popover 范 围 外 点 击 ， 即 可 取消 选择 。 


动作 表 (Action Sheet) 与 UIAlertView 都 是 从 同一 个 源头 类 继承 下 来 的 ， 然 而 两 者 之 间 有 所 区 别 。 从 iPhone 早期 开始 ， 它 们 就 成 了 各 自 不 同 的 类 。 由 于 
UlAlertView 会 从 原 有 的 界面 中 跳出 来 ， 所 以 很 适合 用 来 吸引 用 户 的 注意 力 。 而 动作 表 菜 单 则 会 滑 入 视图 之 中 ， 所 以 更 适合 与 程序 里 正在 执行 的 任务 相 集 成 。Cocoa 
Touch 提 供 了 五 种 表示 菜单 的 方式 : 


- showInView: 在 iPhone 与 iPod touch 中 ， 该 方法 会 将 菜单 从 视图 的 底部 向 上 滑 入 屏幕 。 在 iPad 里 ， 动 作 表 会 出 现在 屏幕 正中 。 


. showFromToolBar: 及 showFromTabBar: 在 iPhone 与 iPod touch? ， 如 果 程 序 里 使 用 了 toolbat (工具 栏 ) ~ tab bar (标签 栏 ) 或 是 其 他 种 类 的 batr， 那 么 这 两 
个 方法 会 先 将 菜单 的 顶部 与 bat 的 顶部 对 齐 ， 然 后 逐渐 将 其 消 入 屏幕 ， 并 准确 地 滑动 到 合适 的 位 置 上 。 所 谓 bar， 就 是 很 多 程序 底部 出 现 的 那 种 条 状 物 ， 其 中 有 许多 组 水 


平 排列 的 按钮 。 在 iPad 上 面 ， 动 作 表 出 现在 屏幕 正中 。 


. ShowFromBarButtonltem: animated: 在 iPad 中 ， 该 方法 会 在 特定 的 UIBar-ButtonItem 上 面 ， 将 动作 表 以 popover 的 形式 展示 出 来 。 
- showFromRect: inView: animated: 一 一 开发 者 可 以 把 视图 里 菜 块 矩 形 区 域 的 坐标 指定 给 该 方法 ， 而 该 方法 则 会 将 动作 表 从 这 块 矩 形 区 域 中 滑 入 屏幕 。 
Qi. 不 要 在 用 作 选 项 卡 的 子 视图 控制 器 里 使 用 showInView。 动 作 表 虽然 能 够 正常 显示 出 来 ， 但 是 Cancel 按 钮 的 底部 却 无 法 响应 用 户 操作 。 


下 面 这 段 代 码 演示 了 如 何 初始 化 并 展示 简单 的 UIActionsheet 实 例 。 切 始 化 方法 中 有 一 个 概念 是 UIAlertView 所 没有 的 ， 那 融 是 Destructive 按 钮 。 这 种 按钮 是 红色 
的 ， 用 以 表示 破坏 性 的 操作 ， 例 如 永久 删除 某 个 文件 (如 图 3-3 所 示 ) 。 鲜 红色 可 以 警示 用 尸 该 选项 有 风险 。 开 发 者 应 该 谨慎 使 用 这 种 选项 。 


图 3-3 ”在 iPhone 和 iPod touch 中 ,动作 表 会 从 视图 底部 滑 入 屏幕 中 。 菜 单 上 的 Destructive 按 钮 呈现 红色 ， 以 便 向 用 户 表示 该 操作 可 能 产生 持久 的 负面 效果 。 如 果菜 单项 
比较 多 ， 那 么 就 会 显示 成 右 侧 那 样 的 滚动 列表 

在 动作 表 中 ， 各 按钮 的 索引 值 与 该 按钮 的 顺序 有 关 。 以 图 3-3 左 侧 为 例 ，Destructive 按 钮 是 0 号 按钮 ， 而 Cancel 按 钮 则 是 4 号 按钮 。 这 和 UIAlertView 的 默认 编号 方 
式 不 同 ，UIAlertView 会 把 Cancel 当 成 0 号 按钮 。 在 动作 表 里 ，Cancel 按 钮 的 序号 由 其 位 置 来 决定 ， 而 它 的 位 置 又 取决 于 开发 者 添加 按钮 的 方式 。 对 于 某 些 没有 
Destructive 按 钮 的 动作 表 来 说 ，Cancel 按 钮 可 能 会 默认 成 为 0 号 按钮 ， 并 成 为 菜单 中 的 首 个 菜单 项 由 ]。 开 发 者 可 以 经 由 动作 表 的 cancelButtonlndex 属 性 来 查看 


Destructive 
One 
Two 


Three 


Cancel 


Cancel 近 钮 的 系 引 值 。 下 面 这 段 代码 会 把 用 尸 所 选 按钮 的 率 引 值 打 印 出 来 : 


{ 


(void)actionSheet: (UIActionSheet *)actionSheet 
didDismissWithButtonIndex: (NSInteger)buttonIndex 


Title 


Destructive 


One 
Two 
Three 
Four 
Five 


Six 


Seven 
Eight 


Nine 


Cancel 


self.title = [NSString stringWithFormat:@"Button %d", buttonIndex] ; 


(void) action: (UIBarButtonItem *)sender 


// Destructive = 0, One = 1, Two = 2, Three = 3, Cancel = 4 


UlIActionSheet *actionSheet = [[UIActionSheet alloc] 
initWithTitle:e"Title" 
delegate:self 
cancelButtonTitle:@"Cancel" 
destructiveButtonTitle:@"Destructive" 
otherButtonTitles:@"One", @"Two", @"Three", nil]; 


[actionSheet showFromBarButtonItem:sender animated: YES] ; 


不 要 在 iPad 上 面 使 用 Cancel 按 钮 。 把 动作 表 展 示 到 iPad 屏 幕 之 后 ， 用 尸 可 以 在 动作 表 的 范围 之 外 点 击 ， 以 取消 这 次 操作 : 


UIActionSheet *actionSheet = [[UIActionSheet alloc] 
initWithTitle:theTitle delegate:nil 
cancelButtonTitle:IS IPAD ? nil : e"Cancel" 
destructiveButtonTitle:nil otherButtonTitles:nil]; 


如 果 在 ijPad 上 面 取消 了 某 个 动作 表 ， 那 么 该 表 (Sheet) 默认 会 返回 -1。 开 上 友 者 可 以 履 写 这 个 值 ， 但 笔者 不 推荐 这 么 做 。 


人 提示 “你 也 可 以 参照 解决 方案 3-1 中 的 BlockAlertView 类 ， 采 用 基于 块 的 方式 来 方便 地 创建 动作 表 。 


译 者 注 


[1] 此 问题 的 详情 可 参考 : https://stackoverflow.com/questions/5262428/uiactionsheet-buttonindex-values-faulty-when-using-more-than-6-custom-buttons o 


3.4.1 ROKR 


有 一 条 大 致 的 规律 : iPhone 及 iPod touch 在 纵 屏 模式 下 最 多 可 以 显示 大 约 10 个 按钮 (包括 Cancel 在 内 ) ， 而 在 横 屏 模式 下 最 多 能 显示 大 概 5 个 按钮 。 (iPad 的 显 
示 空 间 会 比 它 们 大 很 多 。) 如 果 超 过 了 这 个 数量 ， 那 么 系统 就 会 像 图 3-3 右 侧 那 样 ， 以 滚动 列表 的 方式 呈现 菜单 。 请 注意 : 即便 在 这 种 情况 下 ，Cancel 按 钮 也 依然 出 现 
在 整 份 列表 的 下 方 ， 而 不 会 出 现在 列表 里 。 此 时 ，Cancel 按 钮 的 编号 忌 是 排 在 它 前 面 的 那些 按钮 之 后 。 从 图 3-3 中 可 以 看 出 ， 这 种 滚动 式 的 列表 菜单 并 不 美观 ， 所 以 应 
该 尽量 避免 使 用 。 


3.4.2 ”在 动作 表 中 显示 文本 


动作 表 提 供 了 与 UIAlertView 相 同 的 文本 展示 功能 ， 并 且 具 备 更 大 的 绘制 区 域 。 下 面 这 段 代 人 码 演示 了 如 何 用 UIActionsheet 对 象 来 显示 消息 。 通 过 这 种 方式 ， 我 们 
可 以 方便 地 将 多 条 文本 同时 展示 出 来 : 


- (void) show: (id)formatstring,... 
| 
if (!formatstring) return; 
va list arglist; 
va start(arglist, formatstring); 
id statement = [[NSString alloc] 
initWithFormat:formatstring arguments:arglist]; 
va end(arglist); 


UlActionSheet *actionSheet = [[UIActionSheet alloc] 
initWithTitle:statement 
delegate:nil cancelButtonTitle:nil 
destructiveButtonTitle:nil 
otherButtonTitles:G"OK", nil]; 


[actionSheet showInView:self.view]; 


3.5 ”将 操作 进度 告知 用 尸 并 提示 其 稍 等 片刻 


操作 计算 机 程序 时 ， 免 个 了 要 等 待 ， 在 可 以 预见 的 将 来 ， 仍 是 如 此 。 开 发 者 的 职责 之 一 ， 束 是 把 这 种 情况 告诉 有 用户。 我 们 可 以 用 Cocoa Touch 所 提供 的 一 些 类 来 
提示 用 户 ， 请 其 等 待 某 个 操作 执行 完毕 。 这 些 进度 指示 器 有 两 种 形式 ， 一 种 是 在 执行 任务 期 间 持续 显示 的 转 轮 ， 另 一 种 是 随 着 任务 执行 进度 由 左 至 右 增长 的 进度 条 。 
提供 这 两 种 指示 器 的 类 分 别 是 


UIActivitylndicatorView 一 一 这 种 进度 指示 器 就 是 个 旋转 的 圆 形 ， 用 以 提示 用 户 需 要 等 待 菜 个 操作 执行 完毕 ,但 是 ， 它 并 不 能 提供 与 任务 完成 进度 有 关 的 详细 
信息 。iOS 的 UIActivityIndicatofView 很 小 ， 不 过 其 动画 效果 可 以 吸引 用 户 的 注意 力 。 如 果 应 用 程序 里 突然 出 现 需要 打 断 用 户 操作 的 任务 ， 那 么 非常 适合 以 这 种 方式 来 提 


= 
DE 


- UIProgressView 一 一 这 种 视图 用 来 表示 进度 条 。 进 度 条 是 一 种 直观 的 反馈 方式 ， 它 占用 的 空间 相对 较 小 ， 可 以 告诉 用 户 已 经 完成 和 尚 待 完成 的 任务 量 。 它 是 个 
没 水 平方 向 延伸 的 扁平 矩形 ， 并 会 随 着 进度 从 左 至 右 增 长 。 这 种 经 典 的 用 户 界 面 元 件 〈uset interface elemenht， 简 称 UI 元 件 ) 适合 表示 那 种 延迟 较 长 而 用 户 又 需要 知道 处 
理 进 度 的 任务 。 


请 注意 ， 不 要 阻塞 主线 程 。 与 使 用 其 他 GUI 对 象 时 所 应 遵循 的 规则 相同 ， 这 两 个 类 也 必须 在 主线 程 上 使 用 。 计 算 量 比较 大 的 代码 会 阻塞 主线 程 ， 使 得 各 视图 无 法 实 
时 更 新 其 内 容 。 假 如 你 编写 的 代码 阻塞 了 主线 程 ， 那 么 UIProgressView 就 不 会 随 着 进度 实时 更 新 了 ， 而 是 会 卡 在 初始 值 那里 。 


若 想 显示 异步 的 反馈 效果 ， 请 使 用 多 线程 。 例 如 ， 可 以 把 UlActivitylndicatorView 放 在 主线 程 上 ， 同 时 在 另 一 个 线程 里 执行 计算 。 然 后 ， 我 们 可 以 把 另 一 个 线程 
里 的 计算 情况 更 新 到 主线 程 的 UIActivitylndicatorView 上 面 ， 这 样 融 能 平稳 地 修改 进度 条 的 进度 ， 使 用 户 得 知 当前 任务 的 处 理 情况 了 。 


3.5.1 使 用 UIActivitylndicatorView 


UlActivitylndicatorView (活动 指示 器 视图 ) 实例 提供 了 一 种 轻 量 级 视图 ， 以 显示 标准 的 转 轮 图 案 。 使 用 这 种 视图 的 时 候 ， 始 终 要 注意 ， 它 们 是 很 小 的 。 所 有 的 
UIActivityIndicatorView 都 非常 袖珍 ， 如 果 将 其 放 得 太 大 ， 那 么 看 上 去 效果 束 不 好 了 。 


iOS 提 供 了 几 种 不 同 风格 的 UIActivityIndicatorView 类 。UlActivitylIndicatorViewStyleWhite 及 UIActivityIndicatorViewStyleGray 风 格 的 长 度 和 宽度 均 为 20 点 。 
白色 样式 的 指示 器 最 好 放 在 黑色 背景 上 面 ， 而 灰色 样式 的 指示 器 则 最 好 放 在 白色 背景 上 面 。 这 两 种 都 算是 比较 小 巧 的 风格 。UIActivitylndicatorViewstyleWhiteLarge 
风格 用 于 暗色 背景 ， 它 是 最 大 、 最 清晰 的 一 种 风格 ,其 长 度 和 宽度 都 是 37 点 : 


UIActivityIndicatorView *aiv = [(UIActivityIndicatorView alloc] 
initWithActivityIndicatorStyle: 
UIActivityIndicatorViewStylewhiteLarge] ; 


通过 color 属 性 ， 开 发 者 可 以 指定 UIActivitylndicatorView 的 tint color。 设 置 好 的 color 属 性 将 会 覆盖 风格 中 的 相应 颜色 ， 但 是 不 会 改变 该 风格 所 对 应 的 尺寸 (也 
就 是 说 ， 普 通 尺 寸 的 UIActivitylndicatorView 依 然 是 普通 尺寸 ， 而 大 尺寸 的 UIActivitylndicatorView 则 依然 是 大 尺寸 ) : 


aiv.color = [UIColor blueColor]; 
开 上 者 并 不 一 定 要 把 UIActivitylndicatorView 放 在 屏幕 正中 ， 只 要 将 其 放 在 合适 的 位 置 上 即 可 。 由 于 它 是 个 背景 色 透 明 的 图 案 ， 所 以 无 论 背 后 是 什么 视图 ， 它 都 
会 泻 染 在 那个 视图 上 面 。 我 们 应 该 根据 背后 那个 视图 的 主要 颜色 来 指定 UIActivitylndicatorView 的 颜色 。 


一 般 情 况 下 ， 只 需 把 UIActivitylndicatorView 作 为 子 视图 添加 到 Window (视窗 ) 、View (视图 ) 、Toolbar (工具 栏 ) Navigation Bar (导航 栏 ) 之 中 ， 即 
可 令 其 出 现在 它们 前 方 了 。 分 配 好 指示 器 所 用 的 内 存 之 后 ， 可 以 用 框架 或 Auto Layout 约 束 来 初始 化 它 的 尺寸 ， 然 后 还 可 以 令 其 在 上 级 视图 里 居中 。 向 对 象 友 送 
startAnimating 消 息 ， 即 可 局 动 指示 器 的 动画 效果 。 调 用 stopAnimating， 则 可 令 其 停止 ， 系 统 会 把 停止 后 的 UlActivityIndicatorView 隐 藏 起 来 ， 其 余 的 事情 则 由 
Cocoa Touch 来 处 理 。 


3.5.2 使 用 UIProgressView 


有 了 UIProgressView 之 后 ， 我 们 融 可 以 把 任务 的 处 理 进 度 告诉 用 户 了 ， 而 不 是 仪 仪 说 句 “请 稍 等 ”。 进 度 条 会 随 着 时 间 的 推移 而 填充 自身 内 容 ， 它 用 填充 程度 来 
表示 任务 的 完成 进度 。 进 度 条 很 适合 用 在 那 种 等 待 时 间 比 较 长 的 任务 上 面 ， 用 户 可 以 通过 它 所 提供 的 状态 反馈 ， 得 知 程序 依然 在 正常 运作 。 

要 创建 进度 条 ， 首 先 得 分 配 UIProgressView 实 例 并 设 定 其 frame。 开 始 使 用 进度 条 时 ， 需 要 调用 setProgress: 方法 。 该 方法 接受 一 个 浮 点 型 的 参数 ， 其 值 位 于 
0.0 至 1.0 之 间 。0.0 所 对 应 的 进度 是 0%， 表 示 “没有 任何 进度 ”， 而 1.0 所 对 应 的 进度 则 是 100%， 表 示 “ 任 务 已 完成 ”。 进 度 条 有 两 种 风格 : 一 种 偏 白 ， 另 一 种 是 浅 灰 
色 [1]。 开 发 者 使 用 setStyle: 方法 来 指定 风格 ,该 方法 的 参数 值 可 以 取 UIProgressViewStyleDefault 或 UIProgressViewStyleBar。 后 者 适用 于 工具 栏 中 的 进度 条 。 


[1] 实际 效果 请 参见 : https://developer.apple.com/library/ios /documentation/userexpetience /conceptual/mobilehig/Controls.html 译 者 注 


3.6 解决 方案 : 在 屏幕 上 绘制 模仿 的 进度 指示 器 


时 说 UIAlertView 及 UIAction-sheet 向 用 户 提供 了 直观 的 通讯 及 互动 方式 ， 但 是 开 友 者 却 不 能 在 其 中 添加 自己 的 子 视 图 。 所 以 ， 为 了 实现 模 态 的 进度 指示 器 ， 我 们 
必须 从 头 开 始 来 实现 目 己 的 UIView。 解 决 方案 3-3 在 设备 屏幕 上 绘制 了 一 个 颜色 较 淡 的 UIView 对 象 ， 并 在 其 中 添加 了 UIActivitylndicatorView。 


Please walt... 


F 


4> 


图 3-4 ”装配 了 UIActivityIndicator 的 模 态 视图 ， 可 以 在 程序 执行 同步 操作 〈 或 称 阻塞 式 操作 ) 时 向 用 户 展 示 反 馈 效果 。 开 发 实际 的 应 用 程序 时 ， 要 记得 给 用 户 提供 一 种 
操作 方式 ， 令 其 在 无 须 强行 退出 程序 的 前 提 下 ， 能 够 把 比较 耗 时 的 任务 取消 掉 


如 图 3-4 所 示 ， 这 个 UlView 覆 盖 在 整个 屏幕 之 上 。 占 满 全 屏幕 是 为 了 能 把 导航 栏 也 覆盖 进去 。 这 种 UlView 必 须 添加 到 应 用 程序 的 视窗 (window) 中 ， 而 不 是 像 
有 些 读 者 想 的 那样 ， 添 加 到 主 UIViewController 的 视图 中 。 那 个 视图 只 能 涵盖 导航 栏 以 下 的 那些 空间 (用 UlScreen 的 术语 来 说 ， 就 是 只 能 涵盖 应 用 程序 窗口 的 外 
框 ) ， 所 以 没有 办 法 阻止 用 户 继续 操作 导 舰 栏 上 的 按钮 及 其 他 物件 。 填 满 整个 视窗 (window) 可 以 阻止 用 户 去 操作 那些 东西 。 


解决 方案 3-3 ”展示 并 隐藏 定制 的 模 态 UIView 


- (void)removeOverlay: (UIView *)overlayView 


| 


[overlayView removeFromSuperview]; 


- (void)action 


| 


UIWindow *window = self.view.window; 


// Create a tinted overlay, sized to the window 
UIView *overlayView - 

[[UIView alloc] initWithFrame:window.bounds]; 
overlayView.backgroundColor - 


[[UIColor blackColor] colorWithAlphaComponent:0.5f]; 
overlayView.userInteractionEnabled - YES; 


// Add an activity indicator 
UlActivityIndicatorView *aiv = 
[[UIActivityIndicatorView alloc] 
initWithActivityIndicatorStyle: 
UIActivityIndicatorViewStyleWhiteLarge] ; 

[aiv startAnimating] ; 

[overlayView addSubview:aiv] ; 

PREPCONSTRAINTS (aiv) ; 

CENTER VIEW(overlayView, aiv); 


UILabel *label = [[UILabel alloc] init]; 
label.textColor = [UIColor whiteColor]; 
label.text = @"Please wait..."; 

[overlayView addSubview:label]; 

PREPCONSTRAINTS (label); 

CENTER VIEW H(overlayView, label); 

CENTER VIEW V CONSTANT (overlayView, label, -44); 


[window addSubview:overlayView]; 

// Use a time delay to simulate a task finishing 

[self performSelector:@selector (removeOverlay: ) 
withObject:overlayView afterDelay:5.0f]; 


为 了 阻止 用 户 触摸 其 他 物件 ， 我 们 把 这 个 UIView 对 象 的 userlnteractionEnabled 属 性 设 为 YES。 这 样 就 可 以 令 它 把 全 部 触摸 事件 都 捕获 起 来 ， 从 而 阻止 这 些 事件 
到 达 下 方 的 其 他 GUI。 由 于 用 户 在 这 个 UIView 消 失 之 前 无 法 操作 其 他 控件 ， 所 以 这 种 做 法 也 就 等 于 创建 出 了 模 态 的 显示 效果 。 只 需 对 本 例 稍 加 改编 ， 即 可 实现 出 一 种 
触摸 之 后 就 会 消失 的 UIView。 但 要 注意 : 由 于 这 种 UIView 并 不 属于 视图 控制 器 ， 所 以 在 设备 屏幕 方向 帮 生 改变 时 ， 它 并 不 会 自我 更 新 。 假 如 想 令 程序 自动 适应 设备 的 
横 屏 / 纵 屏 状态 ， 那 么 可 以 先 查询 当前 的 屏幕 方向 ， 然 后 再 根据 方向 来 显示 这 个 UIView， 同 时 ， 还 应 该 订阅 与 屏幕 方向 变更 有 关 的 通知 。 


所 击 后 即 可 消失 的 模 态 UlView 


通过 自 定 义 的 UIView， 我 们 既 可 以 展示 消息 ， 又 能 够 限制 用 户 的 操作 。 只 需 对 解决 方案 3-3 中 的 UIView 稍 加 扩充 ， 融 能 实现 出 一 种 点 击 后 即 可 消失 的 视图 。 用 户 
点 击 这 种 视图 之 后 ， 它 会 把 自己 从 屏幕 中 移 除 。 平 常 适合 以 UIAlertView 来 展示 的 消息 现在 也 很 适合 改 用 这 种 视图 来 显示 : 


@interface TappableOverlay : UIView 

@end 

@implementation TappableOverlay 

- (void) touchesEnded: (NSSet *)touches withEvent: (UIEvent *) event 


| 


// Remove this view when it is touched 


[self removeFromSuperview]; 


@end 


3.7 解决 万 案 : 目 制 的 模 态 警告 


UIAlertView 的 功能 太 少 ， 而 且 不 够 灵活 ， 所 以 其 用 途 比 较 有 限 。 解 决 方案 3-3 实 现 了 一 个 简单 的 模 态 窗口 ， 非 常 适合 在 程序 执行 比较 耗 时 的 任务 时 向 用 户 显 示 消 
息 。 有 时 候 ， 我 们 融 是 需要 这 样 一 种 功能 完备 并 且 可 以 自行 配置 的 警告 视图 ， 而 不 想 使 用 由 苹果 公司 施加 了 人 为 限制 的 UIAlertView。 


解决 方案 3-4 提 供 的 这 种 警告 视图 的 各 方面 几乎 都 可 以 由 开 友 者 来 定制 。 你 可 以 根据 需求 向 其 中 添加 子 视图 或 配置 UI 元 件 ， 可 供 配置 的 内 容 包括 边框 、 背 景 以 及 子 
视图 的 位 置 等 。 使 用 我 们 目 编 的 警告 视图 来 取代 系统 内 置 的 UIAlertView 会 有 个 好 处 ， 融 是 可 以 自己 指定 切换 时 的 动画 效果 。 解 决 方案 3-4 人 在 展示 和 隐藏 警告 视图 的 时 
候 ， 都 使 用 了 弹出 效果 。 弹 出 效果 是 通过 仿 射 缩放 变换 来 实现 的 ， 第 5 章 将 会 详 述 此 问题 


Qi. 苹果 公司 在 iDOS 7 里 引入 了 一 套 基 于 物理 的 动画 系统 ， 叫 作 Dynamics。 为 了 在 显示 和 隐藏 警告 视图 的 时 候 模拟 弹出 效果 ， 本 范例 所 采用 的 做 法 是 对 视图 进 
行 变 换 ， 但 假如 改 用 Dynamics 来 做 的 话 ， 那 么 还 能 以 声明 式 的 方法 添加 更 为 复杂 的 视觉 交互 。 


由 图 3-5 可 以 看 出 ， 这 种 警告 视图 不 会 将 开发 者 局 限 在 一 套 特 定 的 界面 之 中 ， 而 是 提供 了 一 张 可 以 随时 定制 的 日 板 (blank slate) 。 笔 者 在 其 中 添加 了 标签 和 按 
钮 ， 以 演示 它 的 用 法 。 
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图 3-5 iOS 系 统 所 提供 的 UIAlertView 的 功能 非常 有 限 ， 而 笔者 自己 编写 的 这 种 警告 视图 则 能 使 开发 者 对 用 户 界面 及 交互 方式 做 出 全 方位 定制 


磨砂 玻璃 效果 


在 iOS 7， 尤 其 是 Control Center (控制 中 心 ) 中 ， 我们 可 以 看 到 一 种 新 的 视觉 效果 ， 它 叫 作 磨砂 玻璃 效果 ， 笔 者 把 这 种 效果 运用 到 了 自 定义 的 警告 视图 中 。 苹 果 
公司 令 许 多 UI1Kit 元 件 都 默认 支持 该 效果 ， 其 中 包括 UlTabBar、UlNavigationBar 及 UlToolbar。 


这 些 Bar 类 本 身 束 实现 了 该 特效 ,不 过 除 此 之 外 ， 我 们 没有 其 他 办 法 能 将 其 添加 到 上 自己 的 视图 中 。 苹 果 公 司 提供 了 一 段 范 例 代码 ， 并 为 Ullmage 类 编写 了 
category， 用 以 模拟 此 特效 ,但 其 效果 却 不 如 系统 内 置 的 实现 效果 好 。Ullmage 类 的 category 里 面 所 实现 的 特效 与 系统 内 置 的 特效 还 有 一 些 差距 ， 而 且 泻 染 速 度 也 慢 
得 多 ， 所 以 ， 不 适合 当 作 实时 特效 来 用 。 


为 了 解决 这 个 问题 ， 解 决 方案 3-4 从 UINavigationBar 中 继承 了 子 类 ， 以 便 能 够 使 用 基 类 所 提供 的 特效 。 但 愿 苹果 公司 以 后 会 把 这 项 特性 直接 提供 给 开 友 者 ， 而 不 
是 像 现 在 这 样 ， 必 须 编写 略 显 隐 星 的 代码 才能 使 用 它 。 


解决 方案 3-4 “自制 的 模 态 警告 视图 


@implementation CustomAlert 


| 


UIView *contentView; 


#pragma mark - Utility 

- (void)observeValueForKeyPath: (NSString *)keyPath 
ofObject: (id)object change: (NSDictionary *)change 
context: (void *)context 


if ([keyPath isEqualToString:@"bounds"] ) 
contentView.frame - self.bounds; 


#pragma mark - Instance Creation and Initialization 
- (void) internalCustomAlertInitializer 
// Add size observer 
[self addObserver:self forKeyPath:G"bounds" 
options:NSKeyValueObservingOptionNew context :NULL]; 


// Constrain the size and width based on the initial frame 
self.translatesAutoresizingMaskIntoConstraints - NO; 
CGFloat width = self.bounds.size.width; 
CGFloat height = self.bounds.size.height; 
for (NSString *constraintString in 

@(@"V: [self (-height)]", e"H:[self(s-width)]"]) 


NSArray *constraints - [NSLayoutConstraint 
constraintsWithVisualFormat:constraintString options:0 
metrics:G[G"width":G (width), @"height":@(height) } 
views:NSDictionaryOfVariableBindings(self)]; 

[self addConstraints:constraints]; 

| 

[self layoutIfNeeded]; 

// Add a content view for auto layout 

contentView - [[UIView alloc] initWithFrame:self.bounds]; 
[self addSubview:contentView]; 
contentView.autoresizingMask - 

UIViewAutoresizingFlexibleHeight | 

UIViewAutoresizingFlexibleWidth; 


// Add layer styling 


self.layer.borderColor [UIColor blackColor] .CGColor; 
self.layer.borderWidth = 2; 

self.layer.cornerRadius = 20; 

self.clipsToBounds = YES; 


// Create label 

label = [[UILabel alloc] init]; 

[contentView addSubview: label]; 
_label.translatesAutoresizingMaskIntoConstraints = NO; 
_label.numberOfLines = 0; 

_label.textAlignment = NSTextAlignmentCenter; 


// Create button 

button = [UIButton buttonWithType:UIButtonTypeSystem]; 
[contentView addSubview: button]; 
_button.translatesAutoresizingMaskIntoConstraints = NO; 


// Layout subviews on content view 
for (NSString *constraintString in 
e[e"V:|-[ label]-[ button]-|", 
@"H:|-[ label]-|", e"H:|-( button]-|"]) 
NSArray *constraints - [NSLayoutConstraint 
constraintsWithVisualFormat:constraintString 
options:0 metrics:nil 


views:NSDictionaryOfVariableBindings( button,  1label)]; 
[contentView addConstraints:constraints]; 


- (instancetype)initWithFrame: (CGRect)frame 
if (!(self = [super initWithFrame:frame])) return self; 
[self internalCustomAlertInitializer]; 
return self; 

- (instancetype)initWithCoder: (NSCoder *)aDecoder 
if (!(self = [super initWithCoder:aDecoder])) return self; 
[self internalCustomAlertInitializer] ; 
return self; 


- (void)dealloc 


[self removeObserver:self forKeyPath:@"bounds"] ; 


#pragma mark - Presentation and Dismissal 


- (void) centerInSuperview 


if (!self.superview) 

{ 
NSLog(G"Error: Attempting to present without superview") ; 
return: 


NSArray *constraintArray - 
[self.superview.constraints copy]; 
for (NSLayoutConstraint *constraint in constraintArray) 
{ 
if ((constraint.firstItem == self) || 
(constraint.secondItem == self) ) 
[self.superview removeConstraint:constraint] ; 


} 


[self.superview addConstraints:CONSTRAINTS CENTERING (self) ]; 


- (void) show 
{ 
self.transform = 
CGAffineTransformMakeScale(FLT EPSILON, FLT EPSILON) ; 
[self centerInSuperview] ; 


CustomAnimationBlock expandBlock = “{self.transform = 
CGAffineTransformMakeScale(1.1f, 1.1£);); 
CustomAnimationBlock identityBlock = ^(self.transform = 
CGAffineTransformIdentity;]); 
CustomCompletionAnimationBlock completionBlock - 
^(BOOL done) { [UIView animateWithDuration:0.3f 
animations:identityBlock] ;}; 


[UIView animateWithDuration:0.5f animations:expandBlock 
completion: completionBlock] ; 


} 


- (void)dismiss 


{ 


CustomAnimationBlock expandBlock = ^(self.transform = 
CGAffineTransformMakeScale(1.1f, 1.1f);}; 
CustomAnimationBlock shrinkBlock = ^(self.transform = 
CGAffineTransformMakeScale (FLT EPSILON, FLT EPSILON) ;}; 
CustomCompletionAnimationBlock completionBlock = 
^(BOOL done) { [UIView animateWithDuration:0.3f 
animations:shrinkBlock] ;}; 


[UIView animateWithDuration:0.5f animations:expandBlock 
completion:completionBlock]; 


@end 


3.8 解决 方案 : 基本 的 popover 


笔者 编写 本 书 时 ， 只 有 iPad 支 持 popover 这 项 特性 。 不 过 将 来 苹果 公司 也 可 能 会 推出 其 他 支持 popover 的 新 iOS 设 备 ， 或 是 把 这 项 特性 移植 到 iPhone 系 列 的 手机 
上 。 有 时 我 们 想 用 模 态 的 视图 去 展示 信息 ， 而 有 的 时 候 则 想 改 用 popover 来 做 。 在 日 常 开 友 中 使 用 popover 时 ， 请 参考 下 面 几 条 经 验 法 则 : 


E 


该 把 popover 对 象 保留 住 。 应 该 创建 强 指针 形式 的 局 部 变量 ， 使 得 系统 能 够 保留 住 popover， 直 到 不 再 使 用 为 止 。 在 解决 方案 3-5 中 ， 程 序 会 在 popover 消 失 时 重 


= 


置 该 变量 。 


解决 方案 3-5 ”基本 的 popover 


(void)popoverControllerDidDismissPopover: 
(UIPopoverController *)popoverController 


// Stop holding onto the popover 
popover - nil; 


- (void)action:(id)sender 


// Always check for existing popover 
if (popover) 
[popover dismissPopoverAnimated:YES]; 


// Retrieve the nav controller from the storyboard 
UIStoryboard *storyboard = 
[UIStoryboard storyboardWithName:@"Storyboard" 
bundle: [NSBundle mainBundle]]; 
UINavigationController *controller - 
[storyboard instantiateInitialViewController]; 


// Pxesent either modally or as a popover 
if (IS IPHONE) 
{ 
[self .navigationController 
presentViewController:controller 
animated: YES completion:nil]; 


| 


else 
// No Done button on iPads 
UIViewController *vc - controller.topViewController; 
vc.navigationItem.rightBarButtonItem - nil; 


// Set the preferred content size to iPhone-sized 
vc.preferredContentSize = 
CGSizeMake(320.0f, 480.0f - 44.0f£); 


// Create and deploy the popover 


popover = [[UIPopoverController alloc] 
initWithContentViewController:controller]; 

[popover presentPopoverFromBarButtonItem:sender 
permittedArrowDirections:UIPopoverArrowDirectionAny 
animated:YES]; 


弹出 新 的 pOpover 之 前 ， 应 该 检查 有 没有 仍 在 显示 中 的 popover， 若 有 ， 则 将 其 隐藏 。 如 果 要 在 程序 里 创建 不 同 用 途 的 多 个 popover， 那 么 尤其 要 注意 这 个 问 


题 。 比 方 说 ， 如 果 有 好 几 个 UIBarButtonItem 都 会 弹出 popover， 那 么 ， 在 显示 新 的 popovet 之 前 ， 应 该 先 把 现 有 的 隐藏 起 来 。 


根据 显示 内 容 设 置 popover 的 尺寸 。iPad 默 认 提 供 的 popover 是 长 而 扁 的 ， 其 风格 可 能 与 你 自己 的 应 用 程序 不 符 。 设 置 视图 控制 器 的 preferredContentSize 属 性 ， 即 


可 指定 popovet 所 应 具备 的 尺寸 。 


. 要 考虑 到 iPhone 上 面 的 显示 效果 。 程 序 运行 在 另 一 种 设备 上 面 时 ， 其 功能 不 应 该 缩减 。 对 于 iPhone 系列 的 手机 来 说 ， 我 们 应 该 通过 控制 器 展示 一 种 与 popovet 类 


似 的 模 态 视图 。 


- 不 要 人 在 popover 上 面 添 加 Done 按 钮 。 一 般 的 模 态 视图 通常 都 会 有 个 Done 按 钮 ， 但 是 不 要 在 popoveft 上 面 放置 这 种 按钮 。 用 户 只 需 在 popovef 范 围 之 外 点 击 ， 即 可 


令 其 消失 ， 所 以 说 ，Done 按 钮 是 多 余 的 。 


Qi iOS 7 刚 发 行 时 ， 革 有 果 公 司 在 开发 文档 里 宣称 ， 不 会 再 用 箭头 图 案 来 表示 popovet 是 从 什么 地 方 弹 出 的 了 。 开 发 文档 把 UIPopovetConttollet 的 popovetAttow- 
Direction 属 性 标注 成 了 deprecated (FFA) 。 不 过 ， 现 在 这 个 箭头 还 在 ， 而 且 SDK 头 文件 里 的 相关 代码 也 还 没有 变 成 deptecated 状 态 。 蔷 果 公 司 可 能 曾 对 popovet 的 设计 做 


出 了 修改 ,但 其 后 又 决定 放弃 修改 ， 然 而 却 没有 立即 更 新 开发 文档 ， 从 而 导致 了 这 种 不 一 致 的 现象 ， 后 续 版 本 的 文档 也 许 会 修复 这 一 问题 1 |。 


[1] 目前 的 开发 文档 已 经 不 再 将 popoverArrowDirection 标 注 为 deprecated 了 。 译 者 注 
3.9 ERASE: 本 机 通 和 和 
本 机 通知 (local notification) 是 一 种 在 程序 未 运行 的 时 候 通 知 用 户 的 手段 。 用 这 种 简单 的 方式 ， 我 们 可 以 在 特定 的 日 期 和 时 间 点 显示 一 条 提醒 信息 。 与 推送 通 


知 不 同 ， 本 机 通知 无 须 联 网 ， 也 不 用 和 远程 服务 器 相通 信 。 正 如 其 名 称 所 示 ， 它 是 一 种 完全 可 以 在 设备 本 地 处 理 的 通知 形式 .。 


本 机 通知 是 与 日 历 及 待 办 事项 清单 等 日 程 安排 工具 结合 起 来 使 用 的 。 某 些 多 任务 应 用 程序 在 没有 运行 于 前 台 时 ， 也 可 以 经 由 本 机 通知 来 向 用 尸 提 供 更 新 。 比 方 
说 ， 用 户 距离 当地 某 家 图 书 馅 很 近 的 时 候 ， 基 于 位 置 的 应 用 程序 也 许 融会 弹出 一 条 通知 ， 告 诉 用 户 现在 可 以 去 查阅 书籍 了 。 


应 用 程序 处 在 活动 状态 时 ， 系 统 不 会 展示 本 机 通知 ， 只 有 当 其 进入 暂停 状态 或 切换 到 后 台 运 行 时 ， 才 会 显示 这 种 通知 。 解 决 亡 案 3-6 安 排 了 一 条 通知 ， 定 于 5 秒 钟 
之 后 弹出 ， 为 了 到 时 候 能 把 通知 显示 出 来 ， 需 要 强迫 应 用 程序 退出 。 假 如 你 开 皮 的 程序 想 在 App Store 上 架 ， 那 可 别 这 么 做 ;笔者 此 处 只 是 为 了 演示 。 如 果 我 们 不 把 这 
个 范例 程序 强行 关闭 的 话 ， 到 时 候 可 能 会 错过 通知 。 


解决 方案 3-6 ”安排 一 条 本 机 通知 


- {void)action: (id) sender 


| 


UIApplication *app = [UIApplication sharedApplication]; 


// Remove all prior notifications 
NSArray *scheduled = [app scheduledLocalNotifications] ; 
if (scheduled.count) 

(app cancelAllLocalNotifications]; 


// Create a new notification 
UILocalNotification* alarm - 
[[UILocalNotification alloc] init]; 
if (alarm) 
| 
alarm.fireDate - 

[NSDate dateWithTimeIntervalSinceNow:5.0f]; 
alarm.timeZone - [NSTimeZone defaultTimeZone]; 
alarm.repeatInterval - 0; 
alarm.alertBody = @"Five Seconds Have Passed"; 
[app scheduleLocalNotification:alarm]; 

// Force quit. Never do this in App Store code. 
exit(0); 


与 推送 通知 一 样 ， 如 果 用 户 点 击 了 显示 本 机 通知 的 按钮 ， 那 么 系统 就 会 重新 运行 应 用 程序 ， 并 把 控制 权 交 给 application: didFinishLaunchingWithOptions: 75 
法 。 以 UIApplicationLaunchOptionsLocalNotificationKey 为 键 ， 在 launchOptions 参 数 所 表示 的 字典 中 查询 ， 即 可 找到 与 本 机 通知 有 关 的 那个 对 象 。 


某 些 开发 者 想 利用 这 种 重 局 应 用 程序 的 效果 ， 经 由 通知 中 心 来 添加 一 些 特色 功能 ， 这 人 么 做 有 时 可 行 ， 有 时 不 可 行 。 该 做 法 背后 的 思路 是 : 添加 本 机 通知 之 后 ， 如 
果 用 尸 点 击 了 这 条 通知 ， 那 么 系统 就 会 局 动 我 们 的 应 用 程序 ， 而 此 时 可 以 执行 一 些 任务 。 这 样 做 实际 上 就 等 于 通过 通知 中 心 向 用 户 提 供 了 一 些 功 能 。 对 通知 中 心 的 非 
常规 用 法 并 未 忌 是 得 到 苹果 公司 的 首肯 。 这 种 15 妙 但 是 未 受 认 可 的 使 用 方式 究竟 能 不 能 成 功 ， 很 大 程度 上 要 看 苹果 公司 是 否 会 调整 其 策略 。 


本 机 通知 的 使 用 原则 


不 要 向 用 户 滥 友 通 知 。 本 机 通知 确实 是 一 种 无 须 用 尸 确认 即 可 使 用 的 通知 手段 ， 但 不 能 因为 如 此 就 滥用 它 来 做 营销 。 忆 的 原则 为 : 如 果 某 条 信息 不 是 用 户 专门 指 


明 要 投递 的 ， 那 就 不 要 发 送 这 种 通知 。 (此 原则 也 适用 于 推送 通知 。 即 便 用 户 同 意 接 收 推送 通知 ， 我 们 也 不 应 该 滥 友 消息 。) 


不 请 自 来 的 通知 对 程序 的 用 户 体 验 没 什么 好 的 效果 。 假 如 你 在 用 户 正 吃饭 的 时 候 友 送 通 知 ， 或 是 在 凌晨 三 点 发 送 通 知 ， 那 么 你 所 制作 的 应 用 程序 就 不 会 过 人 喜 
欢 ， 于 是 残 得 不 到 好 评 ， 也 吸引 不 到 更 多 的 用 户 。 


无 论 开 友 者 有 没有 给 用 户 提 供 “ 请 勿 打扰 ”选项 ， 只 要 小 用 通知 ,就 是 种 错误 的 做 法 。 若 是 经 由 推送 通知 来 友 送 广告 ， 那 么 苹果 公司 通常 会 拒绝 这 种 程序 上 架 ， 
使 用 本 机 通知 的 时 候 也 同样 要 注意 这 个 问题 。 最 容易 使 应 用 程序 评分 和 开发 者 声望 受 损 的 做 法 束 是 胡乱 友 送 通知 信息 。 


最 后 还 要 注意 ， 应 该 仔细 检查 通知 内 容 有 没有 拼写 错误 。 


3.10 ”用 网 络 活动 指示 器 提醒 用 户 


程序 在 后 台 联 网 时 ， 开 发 者 应 将 此 情况 告诉 用 尸 ， 这 样 显 得 礼貌 一 些 。 我 们 并 不 需要 创建 全 屏 的 警告 视图 ， 因 为 Cocoa Touch 已 经 提供 了 一 个 简单 的 
UIApplication 属 性 ， 该 属性 能 够 控制 状态 栏 中 旋转 的 网 络 活动 指示 器 。 图 3-6 演 示 了 这 种 指示 器 ， 它 位 于 Wi-Fi 信 和 号 指示 器 的 右 侧 ， 当 前 时 间 的 左 方 。 


Carrier = 


图 3-6 ”网 络 活动 指示 器 是 由 UIApplication 中 的 相关 属性 来 控制 的 
下 面 这 段 代 码 演示 了 该 属性 的 用 法 ， 此 处 我 们 只 不 过 简单 地 切换 了 指示 器 的 开 / 天 状态 : 


- (void) action: (id)sender 


| 


// Toggle the network activity indicator 

UIApplication *app = [UIApplication sharedApplication]; 

app.networkActivityIndicatorVisible = 
lapp.networkActivityIndicatorVisible; 


| 


开发 实际 应 用 程序 时 ， 通 剃 需 要 在 另 一 个 线程 里 执行 与 网 络 有 关 的 任务 。 与 此 同时 ， 开 上 友 者 必须 在 主线 程 上 面 执行 与 Ul 相 天 的 更 新 操作 。 于 是 ， 我 们 可 以 像 下 面 
这 段 代码 一 样 ， 在 其 他 线程 里 通过 GCD 机 制 来 请 求 系统 在 主线 程 上 更 新 GU1: 


dispatch async(dispatch get main queue(), ^l 
// set activity indicator here 


p); 


你 可 以 记录 应 用 程序 里 正在 执行 的 网 络 操作 数目 ， 当 至 少 有 一 个 网 络 操作 处 于 活动 状态 时 ， 才 去 局 用 指示 器 。 
给 应 用 程序 加 上 徽章 形 提示 标志 


使 用 过 iOs 系 统 的 读者 会 友 现 ， 主 屏幕 的 应 用 程序 右上 方 可 能 会 出 现 红色 徽章 图 样 的 小 标志 。 这 些 标 志 里 面 的 数字 也 许 表 示 用 户 上 次 打开 Phone (电话 ) 程序 之 后 
未 接听 的 来 电 数 目 ， 或 是 上 次 打开 Mail (邮件 ) 程序 之 后 未 读 取 的 邮件 数目 。 


用 代码 把 applicationlconBadgeNumber 属 性 设 为 正 整数 ， 即 可 给 应 用 程序 添加 徽章 图 样 的 提示 标志 。 将 applicationlconBadgeNumber 设 为 0， 融 能 隐藏 徽章 
SE. 


如 果 用 户 打 开 了 应 用 程序 ， 那 么 应 该 把 这 个 徽章 形 的 提示 标志 移 除 。 因 为 用 户 一 般 都 认为 ， 只 要 启动 了 某 个 程序 ， 束 可 以 清除 主 画 面 程序 图 标 右上 和 角 的 提示 了 。 


3.11 解决 方案 : 播放 简单 的 提示 音 
应 用 程序 可 以 用 提示 音 直 接 对 用 户 “ 说 话 ”。 对 于 听觉 没有 障碍 的 用 户 来 说 ， 这 是 一 种 即时 的 反馈 手段 所幸 苹果 公司 在 Cocoa Touch SDK 里 面 通 过 System 
Audio 服 务 提供 了 基本 的 声音 播放 功能 . 


除 此 之 外 ， 还 可 以 通过 Audio Queue 来 调用 AVAudioPlayer。 在 程序 中 使 用 Audio Queue 来 播放 声音 是 相当 耗 时 的 ， 它 比 播放 简单 的 提示 音 要 复杂 得 多 。 反 之 ， 
我 们 只 需 几 行 代码 ， 束 能 加 载 并 播放 System Audio 了 。 另 外 ，AVAudioPlayer 也 有 其 缺 点 ， 它 会 干扰 iPod 的 声音 ， 而 System Audio 所 播放 的 声音 则 不 会 打 断 设备 正 
在 播放 的 音乐 ， 只 不 过 提示 音 的 播放 效果 可 能 不 太 理 想 ， 有 时 会 埋没 在 音乐 声 中 。 


提示 音 越 短 越 好 ， 根 据 苹果 公司 的 建议 ， 应 该 保持 在 30 秒 以 内 。System Audio 只 能 播放 PCM 音 频 和 |IMA 音 频 ， 也 就 是 说 ， 只 支持 AIFF、WAV 及 CAF 声 音 格 式 。 


3.11.1 System Sound 
以 指向 声音 文件 的 URL 为 参数 来 调用 AudioservicesCreatesystemSsoundID， 即 可 构建 System Sound。 调 用 完成 之 后 ， 开 发 者 将 获得 一 个 初始 化 过 的 System 
sound 对象， 我 们 可 在 这 个 对 象 上 面 播放 声音 。 以 该 对 象 为 参数 ， 调 用 AudioservicesPlaySystemSound 函 数 ， 即 可 播放 声音 。 下 面 这 行 语 句 就 是 用 来 播放 声音 的 : 


AudioServicesPlaySystemSound (mySound) ; 


如 果 iPod 正 在 播放 其 他 音乐 ， 那 么 它 一 般 会 以 相同 的 音量 来 播放 System Sound， 而 不 会 先 把 音乐 声音 调 小 。 这 样 的 话 ， 用 户 有 可 能 听 不 到 提示 音 。 下 面 这 行 代码 
用 于 判断 设备 当前 的 播放 状态 : 


if ([MPMusicPlayerController iPodMusicPlayer].playbackState == 
MPMusicPlaybackStatePlaying) 


假如 设备 正在 播放 音乐 ， 那 么 开发 者 可 将 当前 音乐 暂停 ， 同 时 在 程序 中 显示 某 个 图 案 ， 也 可 以 考虑 用 本 章 后 面 讲述 的 办 法 ， 给 提示 音 添加 震动 效果 。 要 想 使 用 
MPMusic-PlayerController， 必 须 先 引入 MediaPlayer 模 块 。 下 一 节 将 会 详细 讲解 模块 。 


我 们 也 可 以 在 程序 里 调用 AudioServicesAddSsystemSoundCompletion() 来 添加 一 段 回调 代码 ， 以 便 在 System Sound 播 放 完毕 之 后 执行 。 除 非 需要 接连 不 断 地 播 


放 许 多 时 间 较 短 的 提示 音 ， 人 否则 一 般 都 不 会 用 到 这 项 功能 。 


以 System Sound 对 象 为 参数 来 调用 AudioServicesDisposeSystemSoundlD， 即 可 清理 该 声音 。 这 个 水 数 会 把 声音 对 象 及 相关 的 资源 一 并 释放 。 


3.11.2 ”为 使 用 系统 框 染 而 引入 模块 

想 使 用 System Sound 服 务 ， 我 们 必须 引入 Audio Toolbox 框 以 及 头 文件 。 苹 果 公 司 为 ijOs 7 提供 了 模块 机 制 ， 从 而 简化 了 开发 者 在 Xcode 中 向 代码 里 添加 系统 框 
架 和 头 文 件 时 的 步骤 。 

以 前 我 们 必须 把 想 要 使 用 的 系统 框架 添加 到 应 用 程序 的 目标 中 ， 并 在 源 代码 里 用 #include 宏 指令 把 相关 的 头 文件 包含 进来 。 有 了 模块 这 一 概念 之 后 ， 只 需 在 源 文 
件 顶 部 使 用 一 条 @import 语 句 ， 即 可 将 头 文件 包含 进来 ， 而 且 还 会 把 相关 的 框架 自动 连接 到 当前 的 项 目 : 


®import AudioToolbox; 


通过 模块 机 制 ， 我 们 可 以 更 方便 地 将 苹果 公司 目 这 的 框架 添加 到 上 自己 的 项 目 中 。 不 过 ,模块 的 主要 用 途 是 增加 编译 和 编制 代码 索引 时 的 性 能 。 模 块 中 有 一 份 数据 
库 包 含 了 相关 框架 里 的 全 部 符号 ， 以 供 快 速 查 询 之 用 。 据 说 苹果 公司 曾经 演示 过 : 模块 可 以 缩减 程序 的 构建 时 间 ， 并 能 够 提升 编制 代码 索引 的 速度 ， 在 不 同 的 项 目 上 
面 ， 效 率 可 能 会 提升 200% 甚 至 更 多 ，。 


如 果 用 Xcode 5 来 创建 新 项 目 ， 那 么 默认 会 启用 模块 机 制 。 而 对 于 原 有 的 项 目 来 说 ， 则 可 以 在 Build Settings 里 开局 Enable Modules 选 项 。 


所 有 系统 框 染 都 能 用 作 模 块 。 不 过 ， 目 前 并 没有 办 法 将 目 制 的 框架 转换 成 模块 。 


3.11.3 Bw 


与 提示 音 一 样 ， 震 动 也 能 立刻 吸引 用 户 注意 。 同 时 它 还 有 个 优点 ， 就 是 几乎 适用 于 所 有 用 户 ， 包 括 听 障 用 户 和 视 障 用 户 在 内 。 目 前 ， 只 有 iPhone 平台 支持 震动 。 


此 外 ， 开 上 友 者 只 应 该 偶尔 使 用 震动 才 对 ， 因 为 它 非 单 消耗 设备 的 电量 。 


System Audio 服 务 不 仅 可 以 用 来 播放 声音 ， 而 且 也 能 令 设备 震动 。 我 们 只 需 像 解 决 方案 3- 7 那样 ， 执 行 下 面 这 行 调 用 语句 即 可 : 


AudioServicesPlaySystemSound(kSystemSoundID Vibrate); 


开 友 者 不 能 调整 与 震动 相 天 的 参数 。 每 次 调用 之 后 ， 都 会 产生 一 秒 钟 或 两 秒 钟 的 晨 动 效果 。 人 在 不 广 持 震动 的 平台 上 (例如 iPod touch 和 iPad) ， 调 用 该 函数 是 没 
有 效果 的 ， 但 也 不 会 产生 错误 : 


3.11.4 


- (void)vibrate 


| 


// Vibrate only works on iPhones 


AudioServicesPlaySystemSound (kSystemSoundID Vibrate); 


AudioServicesPlayAlertSoundERZAn] LRN PTB ELM REA (Alert Sound) : 


AudioServicesPlayAlertSound (mySound) ; 


正如 解决 方案 3-7 所 示 ， 调 用 上 述 方 法 之 后 ， 设 备 会 播放 开 友 者 所 指定 的 声音 ， 而 且 还 有 可 能 震动 ， 或 是 再 播放 一 段 旋律 。 在 iPhone 上 面 ， 如 果 用 户 开 局 了 


果 之 后 ， 用 户 残 可 以 感觉 到 了 。 


解决 方案 3-7 ”用 Audioservices 来 播放 系统 音 、 警 示 音 ， 并 产生 震动 效果 


Gimplementation SoundPlayer 


void _systemSoundDidComplete(SystemSoundID ssID, 


中 


| 


void *clientData] 


AudioServicesDisposeSystemSoundID (ssID); 


(void) playAndDispose: (NSString *)sound 


NSString *sndpath = [[NSBundle mainBundle] 
pathForResource:sound ofType:@"wav") ; 
if ((!sndpath) || 
(![[NSFileManager defaultManager] 
fileExistsAtPath:sndpath])) 


NSLog(G"Error: €*G.wav not found", sound); 


return; 


CFURLRef baseURL = 
(CFURLRef ) CFBridgingRetain ( 
[NSURL fileURLWithPath:sndpath] ) ; 


SystemSoundID sysSound; 
AudioServicesCreateSystemSoundID (baseURL, 
CFRelease (baseURL) ; 


Settings» Sounds» Vibrate on Ring 选 项 ， 那 么 该 滔 数 就 会 令 手 机 震动 。 用 户 若是 把 手机 音量 调 得 很 低 或 是 将 其 设 为 静音 ， 则 有 可 能 听 不 到 提示 音 ， 然 而 有 了 震动 效 


&sysSound) ; 


AudioServicesAddSystemSoundCompletion(sysSound, NULL, 


NULL, systemSoundDidComplete, NULL} ; 


if ([MPMusicPlayerController iPodMusicPlayer] .playbackState 
== MPMusicPlaybackStatePlaying) 
AudioServicesPlayAlertSound (sysSound) ; 

else 
AudioServicesPlaySystemSound (sysSound) ; 


gend 
iPad 和 第 二 代 及 以 后 的 iPod touch 都 只 会 通过 自 带 的 扬声器 来 播放 声音 ， 但 不 会 震动 ， 因 为 它们 并 没有 震动 功能 。 第 一 代 iPod touch (不 知 现在 还 能 不 能 找到 这 
MHS! ) 会 在 扬声器 里 播放 一 段 很 短 的 警示 旋律 (alert melody) ， 并 通过 和 耳机 来 播放 开发 者 所 指定 的 声音 。 


在 播放 警示 音 的 时 候 ，iOS 会 自动 调 低 当前 的 音乐 音量 。 假 如 我 们 侦 测 到 设备 正在 播放 音乐 ， 那 么 可 以 改 为 播放 警示 音 ， 而 不 是 系统 音 (System Sound) 。 


3.11.5 ”延迟 
初次 在 iOS 上 面 播 放 系 统 音 时 ， 可 能 会 产生 延迟 。 为 了 避免 这 一 问题 ,我 们 可 以 在 应 用 程序 初始 化 的 时 候 ， 先 播放 一 段 安 静 的 声音 ， 这 样 的 话 ， 稍 后 播放 系统 音 时 
束 不 会 有 延迟 了 。 


Qe “在 iphone 上 面 测试 的 时 候 ， 记 得 不 要 把 手机 左 侧 的 静音 开关 打开 。 如 果 打开 了 ， 那 么 系统 就 不 能 播放 警示 音 了 。 很 多 iphone 开 发 者 都 忽视 了 这 一 问题 。 候 


如 一 定 要 确保 提示 音 总 能 播放 出 来 ， 那 么 请 改 用 AVAudioPlayet 类 。 


3.11.6 WARS 


别 志 了 释放 系统 音 。 我 们 应 该 在 dealloc 方 法 里 面 处 理 这 些 事情 ， 以 便 在 对 象 的 生命 期 结束 时 释放 相关 资源 。 编 写 代 码 时 应 该 考虑 到 声音 的 生命 期 ， 并 且 要 找到 适 
当 的 方式 将 声音 资源 释放 挥 。 

对 于 很 多 应 用 程序 来 说 ， 即 便 在 某 个 对 每 或 整个 程序 的 生命 期 里 一 直 保 留 儿 个 声音 资源 ， 也 不 会 占用 多 少 内 存 。 但 对 于 另外 一 些 应 用 程序 来 说 ， 则 必须 在 播放 完 
声音 之 后 尽快 将 其 清理 干净 。 开 发 应 用 程序 时 ， 一 定 要 注意 声音 资源 的 释放 问题 ， 在 用 完了 声音 资源 之 后 ， 务 必 将 其 释放 ，。 


在 新 版 的 Xcode 中 ，iOS 模 拟 器 已 经 完全 支持 声音 回放 了 。 


3.12 ”小结 


本 章 讲述 了 在 应 用 程序 里 直接 同 用 户 交 互 的 几 种 途经 。 大 家 学 会 了 如 何 通 过 视觉 、 听 党 及 触 洁 等 形式 的 提醒 机 制 来 吸引 用 户 的 注意 力 ， 并 请 求 用 户 即 刻 做 出 回 
应 。 本 章 所 提供 的 这 些 范例 既 增强 了 应 用 程序 的 互动 效果 ， 又 利用 了 iPhone 所 特有 的 一 些 功能 。 在 学 习 下 一 章 之 前 ， 大 家 可 以 先 回顾 下 面 几 个 问题 : 


. 当 需 要 用 户 立刻 来 操作 应 用 程序 时 ， 可 以 弹出 警告 视图 。 它 们 既 能 传达 信息 ， 又 可 以 提醒 用 户 做 出 回应 。 系 统 自己 提供 的 UIAlertView 功 能 不 多 ,但 是 实现 起 来 
很 快 ， 而 且 很 容易 。 正 如 大 家 在 本 章 中 所 见 ， 我 们 可 以 自己 编写 一 种 非常 强大 的 警告 视图 ， 以 便 实现 一 套 非常 灵活 而 且 可 供 定制 的 操作 界面 。 

` 假如 有 项 任务 比较 耗 时 ， 那 么 开发 者 应 该 以 某 种 反馈 方式 向 用 户 显示 它 的 执行 进度 。iO 〇 OS 提供 了 许多 反馈 方式 ， 包 括 HUD (heads-up display， 直 接 出 现在 程序 画 
面 上 的 显示 信息 ) 、 状 态 栏 上 的 指示 器 以 及 其 他 种 种 手段 。 我 们 应 该 把 任务 中 的 非 GUI 元 件 (non-GUIelement) 移 到 新 的 线程 里 ， 以 避免 阻塞 主线 程 。 如 果 有 可 能 的 
话 ， 还 应 向 用 户 提供 一 种 可 以 取消 当前 任务 的 手段 。 

偶尔 可 以 用 一 下 本 机 通知 。 只 有 当 确 实 有 必要 向 用 户 发 送 通 知 的 时 候 ， 才 应 该 显示 它们 。 假 如 滥用 本 机 通知 机 制 来 显示 消息 ， 那 么 用 户 很 快 就 会 讨厌 你 的 程 
序 ， 并 将 其 从 设备 中 删 掉 。 

. 系统 所 提供 的 特性 不 会 完全 符合 每 个 应 用 程序 的 设计 需求 ， 而 且 系统 也 不 应 该 把 它们 全 都 包办 了 。 你 应 该 尽量 用 UIView 实 例 及 动画 效果 构建 出 符合 自己 程序 的 
警告 视图 及 菜单 。 

:包括 响 铃 及 震动 在 内 的 各 种 音频 反馈 手段 都 可 以 提升 并 丰富 应 用 程序 的 交互 能 力 。 播 放 系 统 音 时 ， 不 会 干扰 到 iPod 自己 的 播放 ， 所 以 它 不 会 打 断 用 户 正 在 聆听 的 
音乐 。 同 时 要 注意 ， 提 示 音 别 播放 得 太 过 频繁 了 。 我 们 应 该 谨慎 而 明智 地 使 用 警示 音 ， 不 要 令 用 户 感到 厌烦 。 


第 4 草 "HEU EJIIS 


开发 者 可 以 通过 UlView 类 及 其 子 类 在 iO0S 设 备 的 屏幕 中 显示 内 容 。 本 章 打算 从 头 开始 讲解 视图 。 你 将 学 会 如 何 构 建 、 检 人 视 并 分 解 视图 层级 ， 也 会 了 解 到 多 个 视图 
之 间 是 怎样 协同 运作 的 。 你 会 友 现 ， 在 界面 中 创建 并 摆 放 视图 位 置 的 时 候 是 需要 一 些 空间 排列 知识 的 ， 此 外 ， 笔 者 还 会 讲解 如 何 设 定 视 图 在 移动 和 切换 时 的 动画 效 
果 。 


第 5 草 将 会 介绍 Auto Layout (自动 布局 ) ， 它 是 一 套 视图 布局 系统 ， 玉 用 了 声明 式 的、 基于 约束 的 模型 。 在 声明 式 编程 中 ， 开 发 者 会 向 SDK 摘 述 出 应 用 程序 或 界 
面 的 行为 方式 ， 而 系统 则 会 在 运行 期 来 实施 相关 规则 。 我 们 通过 约束 规则 (Constraint rule) 来 描述 界面 。 约 束 会 影响 到 视图 的 排 布 方式 及 平面 结构 。 


无 论 是 否 使 用 Auto Layout， 都 应 该 理解 视图 的 基本 平面 特征 (1]|， 因 为 这 对 于 构建 用 户 界面 来 说 是 至 关 重 要 的 。 


[1] 本 章 所 说 的 “几何 ” (geometry) 一 词 大 多 是 与 “位 置 、“ 尺 寸 ” 这些 平面 特征 有 关 的 概念 ， 与 经 典 意 义 上 的 “几何 学 ”并 不 完全 相同 。 


译 者 注 


4.1 ”视图 层级 


我 们 可 以 用 树 状 层级 来 分 解 'OS 屏 幕 。 从 主 视 窗 开 始 ， 各 种 视图 都 是 依照 特定 的 层次 来 排 布 的 。 所 有 视图 都 可 以 有 下 级 ， 这 些 下 级 视图 就 叫 作 子 视图 。 包 括 视窗 在 
内 的 每 个 视图 都 有 一 份 有 序列 表 ， 用 来 保存 它 的 下 级 视图 。 一 个 视图 可 以 含有 好 多 个 子 视图 ， 也 可 以 不 包含 任何 子 视图 。 视 图 之 间 的 排 布 方式 以 及 从 属 关 系 由 应 用 程 
序 来 决定 。 


子 视图 是 按照 由 后 至 前 的 顺序 显示 的 ， 就 像 是 去 起 来 的 动画 绘制 板 (animation cel, zJJBIZENATS. HRA) 一 样 。 手 绘 动画 时 ， 我 们 会 在 很 多 张 透 明 的 板子 里 
绘制 卡通 图 样 ， 然 后 将 其 上 下 赤 放 起 来 。 每 张 板 子 上 都 只 绘制 一 部 分 内 容 ， 以 便 使 下 方 的 图 案 能 够 透 过 来 。 我 们 可 以 透 过 没有 上 色 的 部 分 看 到 人 它 后 面 那 些 板 子 上 的 图 
案 。 视 图 也 是 如 此 ， 开 友 者 可 以 在 每 张 视图 上 面 都 只 绘制 一 部 分 内 容 ， 然 后 将 其 赤 放 起 来 ， 以 产生 复杂 的 视 总 效果。 


图 4-1 以 分 层 的 方式 剖析 了 一 个 常见 的 应 用 程序 视窗 。 此 处 的 视窗 拥有 一 套 基于 UINavigationController 的 体系 ， 其 中 的 各 个 视觉 元 件 都 是 分 层 去 放 起 来 的 。 视 窗 
(也 融 是 最 右 侧 的 那个 空 日 元 件 ) 本 身 拥 有 导航 栏 及 表格 。 导 航 栏 拥有 按钮 及 标题 标 釜 ; 而 表格 也 有 其 自己 的 子 视 图 。 这 些 物件 埃 放 起 来 ， 融 构成 了 整个 程序 的 GUIl. 


Edit 


Pick up milk 


Gall Anne 


图 4-1 将 各 个 子 视图 层级 县 放 起 来 ， 以 构建 复杂 的 GUI 


程序 清单 4-1 列 出 了 图 4-1 中 的 视窗 所 具备 的 视图 层级 。 这 个 树 状 结构 从 顶端 的 UIWindow 开 始 ， 列 出 每 个 子 视图 所 对 应 的 类 名 。 沿 着 树 状 结构 往 下 看 ， 会 发 现 导 
航 栏 位 于 第 2 级 ， 导 航 柱 上 的 按钮 位 于 第 3 级 ， 而 表格 视图 则 位 于 第 4 级 ， 其 中 的 两 个 单元 格 位 于 第 6 级 。 清 单 中 的 某 些 物 件 是 iOS 私 用 的 类 ， 它 们 是 在 系统 排 布 视图 的 时 
候 由 SDK 目 动 添加 进去 的 。 例 如 ，UlLayoutContainerView 束 是 个 开发 者 不 会 直接 去 使 用 的 类 。 在 SDK 里 ， 它 是 UIWindow 实 现代 码 的 一 部 分 。 


程序 清单 4-1 ”以 待 办 清单 的 方式 列 出 视图 层级 


--[ 1] UILayoutContainerView 

----{ 2] UINavigationTransitionView 

------ [ 3] UIViewControllerWrapperView 

€—À [ 4] UITableView 

---------- [ 5] UITableViewWrapperView 
———— [ 6] UITableViewCell 

——— [ 7] UITableViewCellScrollView 
NUDO NEM [ 8] UITableViewCellContentView 
———— (€ X [ 9] UILabel 

— —— — n [ 8] UITableViewCellDetailDisclosureView 
en [ 9] UIButton 
—————————Ó [10] UlImageView 
——————— [ 9] UIImageView 


——— [ 6] UITableViewCell 
SS [ 7] UITableViewCellScrollView 
————— [ 8] UITableViewCellContentView 
———— [ 9] UILabel 
E [ 8] UITableViewCellDetailDisclosureView 
——O^—^ OQ [ 9] UIButton 
——— [10] UIImageView 
——MÁÁÁ er [ 9] UIImageView 
~ [ 5] UIImageView 

---------- [ 5] UIImageView 

----[ 2] UINavigationBar 

----+-- [3] UINavigat ionBarBackground 
-------- [ 4] UlBackdropView 

---------- [ 5] UlBackdropEffectView 
---------- [ 5] UIView 

— ÓH [ 4] UIImageView 

------ [ 3] UINavigationItemView 

—— [ 4] UILabel 

------ [ 3] UINavigationButton 

——— [ 4] UIButtonLabel 

------ [ 3] UINavigationButton 

-------- [ 4] UIButtonLabel 

------ [3] _UINavigat ionBarBackIndicatorView 


清单 里 唯一 没有 列 出 来 的 东西 是 表格 中 的 许多 条 行 分 隔 线 。 为 了 节省 篇 幅 ， 笔 者 把 它们 省 略 掉 了 。 每 条 分 隔 线 都 是 UlTableViewSeparatorView 实 例 。 这 些 分 隔 线 
属于 UITableView， 它 们 一 般 出 现在 第 5 级 。 


4.2 解决 万 案 : 用 树 状 图 来 描述 视图 层级 


每 个 视图 都 有 其 上 级 视图 (aView.superview) 和 下 级 视图 (aView.subviews) 。 我 们 可 以 递归 地 人 遍历 某 个 视图 的 所 有 下 级 视图 ， 以 构建 一 棵 像 程序 清单 4-1 那 样 
的 视图 树 。 解 决 方案 4-1 会 在 这 张 树 状 图 中 写 出 每 个 视图 所 对 应 的 类 ， 当 它 从 某 个 上 级 视图 进入 其 下 级 视图 的 时 候 ， 会 增加 缩 进 级 别 。 范 例 代码 会 把 遍历 结果 保存 在 可 
变 的 字符 串 (NSMutableString) 中 ， 并 返回 给 调用 它 的 那个 方法 。 


解决 方案 4-1 提取 视图 层级 树 


// Recursively travel down the view tree, increasing the 

// indentation level for children 

- (void)dumpView: (UIView *)aView atIndent: (int)indent 
into: (NSMutableString *)outString 


// Add the indentation dashes 
for (int i = 0; i < indent; i++) 
[outString appendString:@"--"] ; 


// Follow that with the class description 
[outString appendFormat:@"[%2d] %@\n", indent, 
[[aView class] description] ] ; 


// Recurse through each subview 
for (UIView *view in aView.subviews) 
[self dumpView:view atIndent:indent + 1 into:outString] ; 


// Start the tree recursion at level 0 with the root view 

- (NSString *)displayViews: (UIView *) aView 

{ 
NSMutableString *outString = [NSMutableString string] ; 
[self dumpView:aView atIndent:0 into:outString] ; 
return outString; 


程序 清单 4-1 中 的 树 就 是 由 解决 方案 4-1 中 的 代码 所 构建 的 。 你 可 以 用 displayViews: 方法 来 重 现 程序 清单 4-1， 也 可 以 将 其 复制 到 别 的 应 用 程序 里 ， 以 便 打 印 出 那 
些 程序 的 视图 层级 。 


Giex 有 个 针对 UIView 的 Categoty， 名 为 UIDebugging， 它 里 面包 含 了 一 个 “秘密 ”方法 ， 叫 作 tecutsiveDesctiption。 革 果 公 司 的 《Technical Note TN2239» 文档 
(https: / /developer.apple.com/library/ios/technotes/tn2239/_index.html) 中 说 : 该 方法 会 递归 地 遍历 子 视 图 ， 并 把 每 个 视图 的 desctiption 添 加 到 遍历 结果 之 中 ， 这 样 所 产 
生 的 效果 与 解决 方案 4-1 相 似 ， 只 是 其 可 配置 程度 和 易 读 程度 稍 差 一 些 。 由 于 这 是 个 “私有 方法 ， 所 以 只 应 该 供 调试 器 (debugger) 来 取 用 。 如 果 在 应 用 程序 代码 里 通 
过 某 种 技巧 访问 了 这 个 方法 ， 那 么 可 能 导致 程序 遭 到 App Stote 拒 绝 ， 所 以 笔者 强烈 不 推荐 使 用 它 。 解 决 方案 4-1 所 提供 的 办 法 更 清晰 、 更 灵活 ， 而 且 也 没有 使 用 方面 的 
限制 。 

获取 解决 方案 代码 


访问 https://github.com/erica/iOS-7-Cookbook 网 页 ， 并 打开 “C04Views” 文 件 夹 ， 即 可 找到 与 本 章 中 的 解决 方案 相对 应 的 完整 范例 项 目 。 
探查 XIB 及 故事 板 中 的 视图 


很 多 Xcode 用 户 会 在 Interface Builder (IB) 里 面 创建 视图 及 视图 控制 器 ， 并 用 XIB 文 件 及 故事 板 来 构建 界面 ， 而 不 是 直接 用 程序 代码 去 编写 。 下 面 这 段 代 码 采 用 
解决 方案 4-1 所 提供 的 方法 剖析 从 这 些 资 源 加 载 进 来 的 视图 : 


UIView *sampleView - [[[NSBundle mainBundle] 
loadNibNamed:G"Sample" owner:self options:NULL] objectAtIndex:0]; 
if (sampleView) 


{ 
NSMutableString *outstring = [NSMutableString string]; 
[self dumpView:sampleView atIndent:0 into:outstring]; 
NSLog(G"Dumping sample view: $60", outstring); 


UIStoryboard *storyboard - [UIStoryboard 

storyboardWithName:@"Sample" bundle: [NSBundle mainBundle]]; 
UIViewController *vc = [storyboard instantiateInitialViewController] ; 
if (vc.view) 


{ 
NSMutableString *outstring = [NSMutableString string]; 
[self dumpView:vc.view atIndent:0 into:outstring] ; 
NSLog(@"Dumping sample storyboard: %@", outstring) ; 


解决 方案 4-1 的 范例 代码 里 面包 含 了 用 作 样 例 的 XIB 及 故事 板 文 件 。 读 者 可 自行 编辑 其 内 容 ， 然 后 运行 上 面 这 段 代 码 ， 看 看 你 在 |B 中 创建 的 界面 是 如 何 与 抵 层 结构 
相对 应 的 。 


43 ”解决 万 案 : STM 


视图 采用 数组 来 保存 其 子 视 图 ， 开 发 者 可 通过 subviews 属 性 获取 这 个 数组 。 系 统 先 绘制 上 级 视图 ， 然 后 再 绘制 其 子 视图 ， 而 子 视图 之 间 的 绘制 顺序 则 与 它们 在 
subviews 数 组 中 的 位 置 相 符 。 这 些 子 视图 按照 从 后 人 至 前 的 顺序 来 绘制 ， 它 们 在 数组 里 的 位 置 也 就 反映 了 绘制 的 顺序 。 系 统 会 先 绘制 数组 里 位 置 靠 前 的 子 视 图 ， 然 后 再 
绘制 位 置 靠 后 的 子 视 图 。 


subviews 属 性 只 返回 当前 视图 的 直接 下 属 视图 。 有 时 候 ， 我 们 不 仅 想 获取 某 视图 的 直接 子 视图 ， 而 且 还 想 获 取 那 些 子 视图 的 子 视图 。 解 决 方案 4-2 所 编写 的 
allSubviews() 是 个 信 单 的 递归 遂 数 ， 可 以 完整 地 列 出 任意 视图 的 全 部 下 属 视图 。 若 以 某 视 图 所 在 的 视窗 (也 束 是 view.window) 为 参数 来 调用 它 ， 则 会 列 出 由 该 
UIWindow 所 管理 的 全 部 下 属 视 图 。 如 果 开 发 者 想 搜寻 某 个 特定 的 视图 ， 比 方 说 某 个 滑 杆 (Slider) 控件 或 按钮 控件 ， 那 么 这 份 视图 列表 会 很 有 用 处 。 


iOS 应 用 程序 一 般 只 有 一 个 视窗 ,但 有 的 程序 可 能 会 包含 几 个 视窗 ， 而 每 个 视窗 下 面 又 包含 许多 视图 ， 某 些 视 图 可 能 还 会 显示 在 设备 之 外 的 其 他 屏幕 中 。 我 们 可 以 
在 每 个 视窗 对 象 上 面 遍 历 ， 以 详尽 地 列 出 程序 里 的 所 有 视图 。 解 决 方案 4-2 里 的 allApplicationViews() 阔 数 就 是 用 来 做 这 件 事 的 。 调 用 [[UIApplication 
sharedApplication]windows] 即 可 获得 一 份 数 组 ， 其 中 含有 应 用 程序 的 全 部 视窗 。allApplicationViews0) 立 数 会 毅 历 此 数组 ， 并 把 其 中 的 子 视图 添加 到 存放 返回 结 
的 那个 数组 里 面 。 


解决 方案 4-2 ”与 子 视 图 有 天 的 工具 函数 


// Return an exhaustive descent of the view's subviews 


NSArray *allSubviews (UIView *aView) 


| 


NSArray *results - aView.subviews; 
for (UIView *eachView in aView.subviews) 


| 


NSArray *subviews - allSubviews (eachView); 


if (subviews) 
results - [results arrayByAddingObjectsFromArray:subviews]; 


| 


return results; 


// Return all views throughout the application 
NSArray *allApplicationViews() 


| 


NSArray *results - [[UIApplication sharedApplication] windows]; 
for (UIWindow *window in 
[UIApplication sharedApplication].windows) 


NSArray *subviews - allSubviews (window); 


if (subviews) results - 
[results arrayByAddingObjectsFromArray:subviews]; 


} 


return results; 


// Return an array of parent views from the window down to the view 
NSArray *pathToView(UIView *aView) 


| 


NSMutableArray *array - [NSMutableArray arrayWithObject:aView]; 
UIView *view - aView; 
UIWindow *window - aView.window; 


while (view != window) 


| 


view - [view superview]; 
[array insertObject:view atIndex:0]; 


| 


return array; 


除了 可 以 查询 子 视图 之 外 ， 我 们 还 可 以 查询 每 个 视图 究竟 属于 那个 视窗 。UlView 对 象 的 window 属 性 指向 了 包含 该 视图 的 视窗 。 解 决 方案 4-2 里 面 也 写 了 个 简单 的 
pathToView() 冰 数 ， 可 以 把 从 视窗 到 该 视图 所 经 的 路 径 放 在 一 份 数组 里 ， 返 回 给 调用 者 。 为 了 确定 这 条 路 径 ， 此 水 数 会 有 反复 向 上 寻找 superview， 直 到 发 现 该 视图 所 
属 的 UIWindow 实 例 为 止 。 

我 们 也 可 以 通过 另 一 种 办 法 来 查找 某 视图 所 属 的 上 级 视图 。UIView 的 isDescendant-OfView : 方法 能 够 判断 出 当前 视图 是 否 位 于 另 一 个 视图 的 体系 之 中 ， 即 便 那 
个 视图 并 不 是 当前 视图 的 直接 上 级 ， 该 方法 也 依然 能 够 做 出 判断 。 这 个 方法 返回 简单 的 布尔 值 。YES 表 示 该 视图 与 开发 者 经 由 参数 转 进 来 的 那个 视图 之 间 有 上 下 级 关 
系 ， 前 者 是 后 者 的 下 属 。 


4.4” 官 理子 视图 


UlView 类 里 面 有 许多 方法 可 供 开 友 者 构建 并 管理 视图 。 我 们 可 以 通过 这 些 方法 来 添加 、 排 列 、 移 除 视 图 ， 并 查询 视图 层级 。 如 图 4-1 所 示 ， 视 图 的 层级 决定 了 视 
图 的 绘制 顺序 。 只 要 在 应 用 程序 里 修改 视图 乙 间 的 层级 天 系 ， 融 能 改变 用 户 所 看 到 的 视图 布局 。 下 面 我 们 来 讲 讲 如 何 完 成 昔 见 的 视图 管理 任务 。 


44.1 添加 子 钢 图 
在 视图 对 象 上 面 调用 addSubview : 方法 即 可 添加 子 视 图 。 该 方法 所 添加 的 子 视 图 会 出 现在 视图 的 最 前 方 ， 也 残 是 说 ， 这 个 子 视图 会 出 现在 原 有 的 其 他 子 视 图 之 
上 。 假 如 想 把 子 视图 插入 到 其 他 位 置 ， 那 么 可 以 使 用 SDK 所 提供 的 下 列 三 个 工具 方法 : 
: insertSubview: atIndex: 
: insertSubview: aboveSubview: 


: insertSubview: belowSubview: 


这 些 方法 能 够 控制 插入 子 视图 的 位 置 。 开 发 者 可 以 相对 于 另 一 个 子 视图 来 指定 插入 点 ， 也 可 以 指明 子 视图 应 该 放 在 subviews 数 组 的 哪个 下 标 位 置 上 。above 及 
below 万 法 分 别 会 将 子 视图 插入 到 另 一 个 子 视图 的 前 方 或 后 方 。 对 于 插入 点 之 后 的 那些 子 视图 来 说 ， 插 入 操作 会 使 其 下 标 递 增 ， 但 是 该 操作 并 不 会 把 现 有 的 子 视图 替换 
f, 


44.2 ERRENSUBIER-T AES] 
用 户 操作 应 用 程序 的 时 候 ， 程 序 经 常 需要 重新 排列 视图 ， 或 者 移 除 某 些 视图 。iOS SDK 提 供 了 许多 种 简单 的 方式 来 完成 这 些 操作 ， 开 发 者 可 以 用 相关 的 方法 更 改 视 
图 的 位 置 及 内 容 : 
- [parentView exchangeSubviewAtIndex: i withSubviewAtIndex: j] 方 法 可 用 来 交换 两 个 视图 的 位 置 。 
- bringSubviewToFront: AsendSubviewToBack: 方法 可 以 把 子 视 图 前 移 或 后 移 。 
- 调用 [childView removeFromSuperview] 方 法 ， 可 以 将 子 视图 从 其 上 级 视图 中 移 走 。 假 如 子 视 图 正 显示 在 屏幕 中 ， 那 么 执行 完 该 操作 后 ， 它 就 会 从 屏幕 里 消失 。 


重 排 、 添 加 或 移 除 视图 之 后 ， 系 统 会 自动 重 绘 屏幕 上 的 内 容 ， 以 反映 新 的 视图 布局 情况 。 


44.3 ”UlView 的 回调 方法 


当 视 图 层级 有 变化 时 ， 系 统 可 以 向 相关 视图 友 送 回调 。iOS SDK 提 供 了 六 个 回调 方法 ， 应 用 程序 可 以 通过 这 些 方法 来 追踪 视图 的 移动 以 及 上 级 视图 的 变动 : 


. didAddSubview: 如 果 有 人 通过 addSubview: 方法 或 上 一 节 提 到 的 那 几 个 插入 方法 成 功 地 向 某 个 视图 里 添加 了 一 个 子 视图 ， 那 么 系统 就 会 在 上 级 视图 上 面 


调用 这 个 方法 。 我 们 可 以 在 UIView 的 子 类 里 履 写 该 方法 ， 以 便 在 新 的 子 视图 添加 进来 的 时 候 ， 执 行 一 些 额外 的 操作 。 


- didMoveToSuperview: 如 果 有 人 已 经 把 菜 个 子 视图 移动 到 另 一 个 新 的 上 级 视图 名 下 ， 那 么 系统 就 会 在 子 视图 上 调用 该 方法 。 此 时 子 视 图 可 以 用 菜 种 方式 


来 响应 新 的 上 级 视图 。 如 果 开 发 者 把 子 视图 从 其 上 级 视图 中 移 除 ， 那 么 系统 也 会 调用 该 方法 ， 只 不 过 此 时 子 视图 的 supetview 有 是 nil。 


- willMoveToSuperview: 一 一 在 子 视图 即将 变更 其 上 级 视图 时 ， 系 统 会 调用 该 方法 。 
- didMoveToWindow: 一 一 它 的 回调 时 机 和 didMoveToSupetview 相 仿 ， 但 只 有 当 视 图 移动 到 新 的 视窗 层级 (Window hierarchy) 而 不 是 仅仅 改换 其 上 级 视图 时， 


系统 才 会 调用 它 。 如 果 想 通过 AitPlay 技 术 在 设备 之 外 的 屏幕 上 显示 内 容 ， 那 么 一 般 都 需要 用 到 这 个 方法 。 
: willMoveToWindow: 一 一 在 子 视图 即将 移动 到 别 的 视窗 层级 时 ， 系 统 会 调用 该 方法 。 


如 果菜 个 子 视 图 即将 从 其 上 级 视图 中 移 除 ， 那 么 系统 会 在 上 级 视图 上 调用 该 方法 。 


- willRemoveSubview: 


这 些 方法 很 少 会 用 到 ， 然 而 一 旦 需要 用 到 ， 它 们 融 总 能 帮 上 大 忙 ， 因 为 开 友 者 无 须 预先 知道 子 视 图 或 上 级 视图 所 属 的 类 ， 即 可 为 视图 添加 新 的 行为 。 与 Window 
有 关 的 回调 主要 用 于 在 另外 一 个 UIWindow 中 显示 某 种 视图 ， 例 如 警告 视图 或 是 市 键盘 的 输入 界面 等 。 


4.5 “为 视图 设 定 标 伶 并 得 找 负 图 


IOS SDK 内 置 了 一 套 搜 寻 机 制 ， 可 通过 标签 (tag) 来 查找 子 视图 。 标 签 是 个 表示 视图 身份 的 数字 ， 一 般 来 说 ， 是 个 正 整数 。 我 们 可 以 通过 视图 的 tag 属 性 来 设置 


这 个 标记 ， 比 方 说 ，myView.tag=101。 在 1B 中 ， 我 们 可 通过 Attributes Inspector 来 设置 视图 的 标签 。 图 4-2 演 示 了 如 何在 Attributes Inspector 的 视图 区 域 中 指定 标 
签 


o 


图 4-2 ”通过 IB 的 Attributes Inspectot 为 视图 设 定 标签 


标签 的 值 可 随意 选取 。 系 统 只 预 留 了 0 这 个 特殊 值 ， 对 于 新 创建 出 来 的 视图 来 说 ， 其 标签 值 默 认 是 0。 至 于 具体 应 该 如 何 为 视图 选取 标签 以 及 用 什么 值 来 当 标 签 ， 
都 由 开发 者 自己 决定 。 凡 是 UlView 的 子 类 的 实例 都 能 够 打上 标签 标记 ， 包 括 视窗 和 各 种 控件 在 内 。 假 如 程序 里 有 很 多 按钮 和 开关 控件 ， 那 么 可 以 为 其 设 定 不 同 的 标 
签 ， 使 我 们 能 够 区 分 出 用 尸 操 作 的 到 底 是 哪 一 个 控件 。 开 友 者 可 在 回调 方法 里 加 入 一 套 简 单 的 switch 语 句 ， 以 便 根 据 标签 值 做 出 不 同 的 反应 。 


苹果 公司 很 少 给 子 视图 设置 标签 。 笔 者 唯一 页 到 的 例外 出 现在 UlAlertView 之 中 ， 该 类 会 给 按钮 分 别 设置 值 为 1、2 等 的 标签 ,但 那 已 经 是 很 久 以 前 的 事 了 。 (也 许 
是 苹果 公司 不 小 心 把 设置 标签 的 代码 遗留 到 了 这 个 类 里 吧 。) 假如 你 担心 和 苹果 公司 的 标签 友 生 冲 突 ， 那么 可 以 令 目 己 的 标签 值 人 10 或 100 开 始 ， 或 是 选择 一 个 比 苹果 
公司 可 能 用 到 的 标签 更 大 的 起 始 值 。 


使 用 标签 来 坦 找 视图 


有 了 标签 之 后 ， 我 们 无 须 在 程序 里 传递 各 种 用 尸 界面 元 件 ， 即 可 直接 通过 上 级 视图 来 搜寻 其 下 的 子 视图 。viewWithTag: 方法 可 以 在 某 视图 的 所 有 下 属 中 根据 标 
签 值 来 查找 相关 的 子 视图 。 搜 寻 过 程 是 递归 式 的 ， 所 以 即便 符合 此 标签 的 子 视图 不 是 当前 视图 的 直接 下属， 该 方法 也 依然 能 找 得 到 。 我 们 可 以 调用 [window 
viewWithTag: 101] 语 句 ， 从 Window 开 始 ， 沿 着 整个 树 状 层级 及 其 中 的 各 个 分 支 来 搜索 标签 值 是 101 的 那个 视图 。 假 如 有 多 个 视图 都 具备 相同 的 标签 值 ， 那 么 该 方法 
会 返回 首先 找到 的 那个 。 


viewWithTag: 方法 唯一 的 缺点 在 于 它 返 回 的 是 个 UIView 对 象 。 也 就 是 说 ， 开 发 者 通常 需要 先 把 它 转换 为 适当 的 类 型 ， 然 后 才能 使 用 。 例 如 ， 我 们 需要 用 下 面 这 
两 行 代 码 来 查找 UILabel 控 件 并 设置 其 文本 : 


UILabel *label = (UlLabel *)[self.view.window viewWithTag:1011; 
label.text - G"Hello World"; 


4.6 解决 万 案 : 通过 对 象 天 联机 制 为 视图 设 定名 称 


虽说 标签 是 一 种 识别 视图 对 象 的 便捷 手段 ， 但 某 些 开 友 者 还 是 喜欢 用 名 字 而 非 数 字 来 撒 代 视图 对 象 。 使 用 名 字 的 好 处 是 可 以 令 视图 对 象 在 标签 之 外 多 具备 一 种 表 
达 合 义 的 方式 ， 以 便 使 开发 者 能 够 辨 明 其 身份 。 这 样 一 来 ， 我 们 束 不 用 再 说 “标签 值 是 101 的 那个 视图 ”了 ， 而 是 可 以 把 某 个 开关 控件 取 名 叫 作 lgnition Switch (点 火 
FX) ， 这 个 名 字 本 身 融 能 摘 述 其 用 途 ， 而 且 与 纯 数 字 相 比 ， 它 还 能 充当 “ 目 文档 ” : 


// Toggle switch 
UISwitch *s = (UISwitch *)[self.view viewNamed:@"Ignition Switch"]; 
[S setOn:!s.isOn]; 


我 们 很 容易 就 能 给 UIView 添 加 nametag 属 性 ， 并 使 开发 者 可 以 按照 名 称 来 查找 视图 。 其 中 用 到 的 关键 技术 就 是 Objective-C 运 行 期 程序 库 里 面 的 那 几 个 关联 对 象 
(associated object) 函数 [1。 若 是 曾 为 某 个 类 编写 过 category 类 ， 那 么 你 可 能 会 想到 这 样 一 个 问题 : 假如 现在 要 给 类 里 再 添加 一 个 实例 变量 ， 那 则 不 是 要 创建 新 的 
子 类 ， 并 把 它 放 在 子 类 里 面 才 行 吗 ? 其 实 Associated Object 机 制 并 不 需要 向 类 里 添加 新 的 实例 变量 ， 它 只 是 提供 了 一 种 在 本 对 象 的 直接 存储 区 之 外 使 用 键 值 对 的 手 
段 ， 开 发 者 可 以 把 存储 在 别处 的 某 份 信息 关联 到 当前 这 个 对 象 上 面 。 


解决 方案 4-3 针 对 UIView 类 创建 了 category， 以 实现 nametag。 这 个 category 为 UIView 添 加 了 名 为 nametag 的 新 属性 ， 并 通过 相关 的 Associated Object 函数 来 
实现 该 属性 ， 另 外 ， 它 还 提供 了 viewNamed: 万 法 ， 该 方法 可 根据 名 称 来 寻找 子 视图 。 这 个 方法 会 沿 着 视图 层级 进行 深度 优先 式 的 递归 搜索 ， 并 返回 其 名 称 与 待 查 字 
符 串 相符 的 首 个 子 视 图 。 


在 Interface Builder 中 设 定 视图 名 称 


给 视图 起 了 名 字 之 后 ， 我 们 就 能 依照 名 称 来 获取 子 视 图 ， 而 不 用 再 声明 IBOutlet 实 例 变量 了 。 (至 于 此 做 法 能 否 令 代 码 变 得 更 易 读 懂 且 更 易 维护 ， 则 不 在 本 节 讨 
论 泄 围 内 。) 早 前 我 们 曾经 写 了 一 段 学 例 代 码 ， 用 以 切换 界面 中 的 开 天 控 件 。 现 在 可 以 在 |B 里 面 把 那个 开关 控件 的 名 称 (也 就 是 lgnition Switch) 设 为 一 个 运行 期 属 
性 。 

图 4-3 演 示 了 这 一 操作 。 选 中 任意 视图 ， 然 后 打开 ldentity Inspector (可 通过 View> Utilities» Show Identity Inspector 荣 单项 打开 它 ) 。 找 到 User Defined 
Runtime Attributes 区 域 ， 然 后 点 击 “+” 按 钮 ， 添 加 新 的 属性 。 把 Key Path 设 为 nametag (解决 方案 4-3 会 针对 UIView 类 编写 category， 而 此 处 的 Key Path 要 和 


category 中 所 用 的 属性 名 相符 ) ， 将 Type 设 为 String， 并 将 Value 设 为 视图 的 新 名 字 。 保 存 所 做 的 修改 。 现 在 ,我 们 就 可 以 在 代码 中 使 用 category 里 所 定义 的 
viewNamed: 万 法 来 获取 开关 控件 并 切换 其 状态 了 。 


Custom Class 


Class | UlSwitch 


Identity 


天 -一 一 
Restoration ID | 


User Defined Runtime Attributes 
Key Path Type Value 
nametag String + ignition Switch 


图 4-3 ”通过 IB 的 Atttibutes Inspector， 我 们 可 以 为 任意 视图 设 定 标 签 。 此 外 ， 也 可 以 在 Attributes Inspector £ t At Xi User Defined Runtime Attributes， 并 在 程序 代码 里 通过 


KVC 机 制 (Key-value coding， 键 值 编码 ) 来 获取 这 些 值 。 系 统 加 载 XIB 文 件 的 时 候 ， 会 设 定 好 这 些 值 


解决 方案 4-3 ”为 UIView 添 加 命名 功能 


#import «objc/runtime.h» 
@implementation UIView (NameExtensions) 


// Static variable's address acts as the key 


// Thanks, Oliver Drobnik 
static const char nametag key; 


- (id)nametag 


{ 


return objc getAssociatedObject(self, (void *) &nametag key); 


- (void)setNametag: (NSString *)theNametag 


objc setAssociatedObject(self, (void *) &nametag key, 
theNametag, OBJC ASSOCIATION RETAIN NONATOMIC) ; 


- (UIView *)viewWithNametag: (NSString *)aName 


if (!aName) return nil; 


// Is this the right view? 
if ([self.nametag isEqualToString:aName]) 
return self; 


// Recurse depth first on subviews 
for (UIView *subview in self.subviews) 


| 


UIView *resultView - [subview viewNamed:aName]; 
if (resultView) return resultView; 


// Not found 
return nil; 


- (UIView *)viewNamed: (NSString *)aName 


| 


if (!aName) return nil; 
return [self viewWithNametag:aName] ; 


| 


@end 


Qi 还 有 一 种 给 视图 取 名 的 办 法 ， 就 是 直接 设 定 CALayet 的 名 称 ， 而 不 使 用 Associated Object 机 制 。CALayet 实 例 有 个 name 属 性 ， 能 够 用 来 区 分 不 同 的 


CALayet。 使 用 它 之 前 ， 需 要 先 引 入 Quatt2z Cote 模 块 ， 在 代码 中 ， 可 通过 view.layet 访 问 这 个 CALayet。 


[1] A448 83 X objc_getAssociatedObject Robjc_setAssociatedObject $ A o 译 者 注 


4.7 ”视图 的 几何 特征 


在 苹果 公司 引入 了 Auto Layout 之 后 ， 开 上 者 残 很 少 需 要 像 原来 那样 直接 调整 视图 的 平面 特征 了 ， 不 过 ， 某 些 情况 下 ， 我 们 还 是 需要 直接 去 控制 视图 的 这 些 特 性 。 
而 且 ， 苹 果 公司 所 引入 的 一 些 新 API (比如 与 视图 的 物理 效果 有 关 的 那些 API) 就 与 Auto Layout 配 合 得 不 够 好 。 因 此 ， 还 是 应 该 掌握 一 些 操作 并 调整 视图 平面 特征 的 
基本 方式 。 


几何 属性 定义 了 视图 出 现 的 位 置 、 视 图 的 尺寸 以 及 方向 。 即 便 采 用 了 Auto Layout， 这 些 属性 也 依然 有 效 ， 在 Auto Layout 环 境 下 ， 它 们 会 由 约束 系统 来 管理 。 开 
发 者 仍然 能 够 查看 这 些 属性 ， 并 以 此 来 了 解 视图 的 位 置 及 系统 对 视图 所 做 的 几何 变换 。 


操作 动态 视图 时 ， 由 于 视图 的 生命 期 比较 短 ， 所 以 在 显示 期 间 ， 其 平面 特征 会 持续 变动 ， 于 是 ， 我 们 需要 抛 开 约束 系统 ， 直 接 去 处 理 每 个 视图 的 基本 布局 。 
UIView 类 提供 了 两 个 内 置 的 属性 ， 用 于 定义 与 布局 有 天 的 特征 。 


每 个 视图 都 使 用 框架 来 定义 其 边界 。 框 架 描 述 了 视图 的 轮廓 ， 也 就 是 它 在 上 级 视图 坐标 系 中 的 位 置 、 宽 度 及 高 度 ， 而 相关 的 bounds 及 center 属 性 则 分 别 定 义 了 本 
视图 坐标 系 中 的 框架 矩形 以 及 框架 在 上 级 坐标 系 中 的 几何 中 心 。 这 些 属性 紧密 地 集成 在 一 起 。 


变 了 视图 的 框 尺 之 后 ， 视 图 会 更 新 自己， 以 便 同 新 的 框架 相符 。 假 如 frame 的 宽度 变 大 了 ， 那 么 视图 融会 拉 伸 ， 假 如 框架 的 位 置 变 了 ， 那 么 视图 融会 移动 到 新 位 
置 。 视 图 的 frame 摘 绘 了 其 轮廓 。 本 视图 的 尺寸 并 不 局 限于 其 上 级 视图 的 尺寸 ， 也 不 有 党 屏幕 大 小 的 限制 。 视 图 可 以 比 屏 幕 大 ， 也 可 以 比 屏幕 小 。 同 理 ， 它 可 以 比 上 级 视 
图 大 ， 也 可 以 比 上 级 视图 小 。 子 视图 大 是 比 上 级 视图 还 大 ， 其 可 见 区 域 则 会 越过 上 级 视图 的 边界 。 开 发 者 可 以 通过 上 级 视图 的 clipsToBounds 属 性 来 限定 子 视图 的 可 见 
内 容 ， 将 其 局 限 在 上 级 视图 的 范围 里 。 


视图 还 有 个 transform 属 性 ， 使 开发 者 可 以 经 由 仿 射 变换 来 修改 其 样 狐 。 有 一 些 数学 公式 可 用 来 调整 视图 的 二 维 几 何 特征 。 通 过 变换 ， 可 以 拉 伸 或 挤 压 视图 ， 也 可 
以 对 其 进行 转 转 ， 使 之 变 得 倾斜 。 将 框架 与 transform 属 性 相 搭 配 ， 即 可 完全 定义 出 视图 的 基本 平面 特征 。 


框架 窍 形 就 是 本 视图 在 其 上 级 坐标 系 中 的 轮廓 线 。 我 们 用 CGRect 结 构 来 表示 框架 ， 由 该 结构 的 CG 前 缀 可 知 ， 它 是 Core Graphics 框 架 的 一 部 分 。CGRect 由 原点 
和 尺寸 构成 ， 前 者 是 个 CGPoint， 其 中 含有 横 坐 标 和 纵 坐 标 ， 后 者 是 个 CGSize， 其 中 含有 宽度 与 高 度 。 当 在 Auto Layout 环 境 之 外 创建 视图 时 ， 我 们 通常 会 在 分 配 好 
UlView 之 后 ， 以 rect 为 参数 来 调用 initWithFrame: 方法 。 


CGRect rect = CGRectMake (0.0f, 0.0f, 320.0£, 416.0f); 


myView = [[UIView alloc] initWithFrame:rect]; 


视图 里 面 有 两 个 联系 紧密 而 且 非 常 关键 的 CGRect 型 属性 ， 即 frame 和 和 bounds。 前 者 与 后 者 之 间 的 区 别 在 于 ， 它 们 所 参照 的 坐标 系 不 同 。frame 是 按照 上 级 视图 的 
坐标 系 来 定义 的 ， 而 bounds 则 按 当 前 视图 自己 的 坐标 系 来 定义 。 鉴 于 此 ， 视 图 的 bounds 的 原点 一 般 设 为 0， 而 它 的 坐标 系统 通常 也 从 左上 角 开 始 。 对 于 基 些 视图 ， 比 
如 UlScrollView 来 说 ，bounds 可 能 会 超过 其 可 视 范 围 。 


47.2 ”与 CGRect 有 关 的 工具 负数 

在 前 一 节 中 我 们 看 到 ，CGRectMake0 函 数 可 以 根据 四 个 参数 来 新 建 矩形 ， 这 四 个 参数 分 别 是 原点 的 横 坐标 、 纵 坐标 、 矩 形 宽度 及 高 度 ， 它 是 个 创建 框 架 时 所 需 的 
关键 国 数 。 除 了 CGRectMake( 之 外 ， 还 有 一 些 比较 方便 的 国 数 ， 也 可 以 用 来 操作 CGRect 及 frame: 

. NSStringFromCGRect (aCGRect) 可 把 CGRect 结 构 转换 为 具有 固定 格式 的 字符 事 。 在 调试 的 时 候 ， 开 发 者 可 通过 这 个 函数 把 视图 的 框架 打印 到 控制 台 。 


- CGRectFromString (aString) 函数 可 以 根据 字符 串 中 的 信息 重建 矩形 。 如 果 把 视图 的 框架 以 字符 串 的 形式 放 在 NSUsetDefaults 里 面 ， 那 么 该 方法 可 以 将 其 转 回 


CGRect. 


- 虽说 [INSValue valueWithCGRect: rect] JE BAR, 12°C "T VUES TE SE 9 4870 4] EB Objective-C RK, HIEKE W 8348 BAHAI ARASNSValue E dg, Ka, FA 
者 可 以 根据 需要 ， 把 对 象 添加 到 字典 或 数组 中 。CGRectValue 方 法 可 以 从 NSValue 对 象 里 面 取出 CGRect 结 构 体 。 对 于 Core Graphics F 84 K $ AXA Rit, WAKA Je A Hw 


数 和 方法 ,例如 CGPoint、CGSize 及 CGAffineTransform 等 。 


: CGRectInset (aRect, xinset, yinset) 函数 可 以 创建 出 与 源 和 矩形 中 心 点 相同 但 尺寸 较 小 或 较 大 的 和 王 形 来 。 如 果 inset 为 正 值 ， 那 么 新 抵 形 就 比 原来 小 ， 若 为 负 ， 则 比 
原来 大 。 


: CGRectOffset (aRect, xoffset, yoffset) 可 以 创建 出 与 源 珑 形 大 小 相同 但 位 置 不 同 的 抵 形 ，xoffset 及 yoffset 分 别 表示 横向 和 纵向 偏 移 量 。 该 函数 很 适合 在 移动 框架 
的 时 候 使 用 ， 也 可 以 用 来 创建 简单 的 阴影 效果 。 


- CGRectGetMidX (aRect) 及 CGRectGetMidY (aRect) 函数 分 别 获 取 短 形 中 心 点 的 横 坐 标 和 纵 坐 标 。 这 两 个 函数 很 适合 用 来 查询 bounds 及 ftame 的 中 心 点 。 


: CGRectIntersectsRect (rectl, rect2) 可 判断 出 两 个 CGRect 结 构 体 是 否 相 交 。 此 函数 可 用 于 检测 两 个 长 方形 对 象 有 没有 重 登 。 调 用 CGRect- 
Intersection (rectl, rect2) ， 即 可 得 知 发 生 重 有 登 的 具体 部 位 。 若 没有 重 登 ， 则 返回 空 矩 形 。 (用 CGRectIsNull (rect) 能 够 判断 出 答 形 是 不 是 空 矩 形 。) 还 有 个 与 


CGRectIntersectsRect48 X $7 x Zt] 4ECGRectContainsPoint (rect, point) ， 如 果 给 定 的 点 位 于 〈 非 空 的 ) BAZAN, APA toe sik true. 


: CGRectEqualToRect (rectl, rect2) 用 来 比较 两 个 抵 形 是 否 相同 。 该 函 数 会 判断 两 个 矩形 的 尺寸 及 位 置 是 否 完 全 一 样 。 相 似 的 函数 还 有 


CGSizeEqualToSize (sizel, size2) 及 CGPointEqualToPoint (pointl, point2) ， 它 们 分 别 用 于 比较 CGSize 及 CGPoint 实 例 。 


还 有 几 个 便捷 的 工具 函数 : CGRectDivide0 能 够 把 源 和 矩形 分 成 两 部 分 ， 而 CGRectApplyAffineTransfotm (rect, transform) M) PVA FEIT RR, FICHE EL 


含 变 换 结 果 的 最 小 矩形 返回 给 调用 者 。 


: CGRectZero 是 个 矩形 常量 ， 它 位 于 (0, 0) 这 个 点 ， 且 宽 、 高 均 为 0。 如 果 在 创建 框架 的 时 候 不 能 确定 其 大 小 和 位 置 ， 那 么 可 以 使 用 此 常量 来 表示 。 类 似 的 常量 


还 有 CGPointZero 及 CGSizeZero。 


4.7.3  CGPointSCGSize 


CGRect 绪 构 体 由 两 个 小 的 结构 体 组 成 ， 一 个 是 CGPoint， 它 定义 了 窍 形 的 原点 ， 另 一 个 是 CGSize， 它 定义 了 矩形 的 边界 。CGPoint 用 x 和 y 坐 标 来 描述 矩形 的 位 
置 ， 而 CGSize 里 面 则 有 width 及 height。CGPointMake (x, y) 用 来 创建 CGPoint，CGSizeMake (width, height) 用 来 创建 CGSize。 尽 管 这 两 种 结构 体 看 上 去 似 
平一 样 (都 包含 两 个 浮 点 值 ) ， 但 从 语义 角度 讲 ，iOS SDK 却 认为 它们 是 不 同 的 东西 。CGPoint 用 来 表示 位 置 ， 而 CGSize 用 来 表示 尺寸 。 我 们 不 能 把 某 个 CGSize 设 为 


myFrame.origin, 


由 于 CGRect、CGPoint 及 CGSize 都 是 结构 体 ， 所 以 可 以 使 用 很 多 种 灵活 的 写法 来 初始 化 它们 : 


CGPoint origin = {0, 0}; 

CGSize size = {100, 200}; 

CGRect recti = CGRectMake(0, 0, 100, 200); 

CGRect rect2 = {{0, 0}, {100, 200}}; 

CGRect rect3 = {origin, size}; 

CGRect rect4 = {origin, {100, 200}} 

CGRect rect5 = {.size.width = 100, .size.height = 200, .origin = {0, 0}}; 


上 述 五 个 CGRect 完 全 相同 。 


与 CGRect 一 样 ， 你 也 可 以 在 其 他 几 种 结构 体 与 字符 串 之 间 来 回转 换 。NSstring-FromCGPoint0、NSstringFromCGSize0、CGPointFromstring() 及 
CGSizeFromString() 函 数 可 以 执行 相关 的 操作 。 另 外 ， 也 可 以 把 CGPoint 及 CGSize 转 换 成 字典 ， 反 之 亦 然 。 


4.7.4 CGAffineTransform 


iOS SDK 在 Core Graphics 里 面 实现 了 仿 射 变换 功能 。 仿 射 变 换 可 以 将 一 套 坐 标 系统 变换 成 另 一 套 坐 标 系统 ， 这 些 功能 广泛 地 运用 于 二 维 动画 和 三 维 动画 之 中。 
UIKit 版 本 的 仿 射 变换 采用 3x3 的 和 矩阵 来 定义 UIView 的 变换 效果 ， 也 融 是 说 ， 它 只 文 持 二 维 的 变换 效果 。 三 维 变换 需要 使 用 4x4 的 和 矩 孟 ，Core Animation 中 的 CALayer 
使 用 的 正 是 此 种 矩阵 。 通 过 仿 射 变换 ， 我 们 可 以 实时 地 对 视图 执行 缩放 、 平 移 及 旋转 操作 。 设 置 视 图 的 transform 属 性 ， 即 可 实现 变换 。 例 如 : 


float angle = theta * (PI / 100.0); 
CGAffineTransform transform - CGAffineTransformMakeRotation (angle); 
myView.transform - transform; 


PRESET AP ORATDSCHEAY. PALA, RAER, BAIER AERAR EMEP OA. Ruts RR ER, BAYA 
先 将 视图 平移 到 那个 点 ， 然 后 旋转 ， 最 后 再 把 视图 移 回 来 。 有 很 多 种 办 法 可 以 简化 上 述 操作 ， 其 中 包括 直接 操作 视图 的 layer 属 性 ， 不 过 ， 这 些 办 法 并 不 在 本 章 的 讨论 


如 果 想 撤销 变换 效果 ， 那 么 可 以 把 transform 属 性 设 为 CGAffineTransformldentity。 这 样 做 会 把 视图 的 frame 恢 复 到 它 目 前 的 值 : 


myView.transform = CGAffineTransformIdentity; 


Qi 在 iOS 系 统 中 ，y 坐 标 从 顶部 开始 向 下 增长 ， 这 与 PostSctipt 所 使 用 的 坐标 系统 相似 ， 但 是 却 和 Quattz 的 坐标 系统 相反 ， 基 于 历史 原因 ，Mac 使 用 的 是 Quattz 
坐标 系统 。 在 iOS 系 统 中 ， 原 点 位 于 左上 角 ， 而 不 是 左下 角 。iOS 一 直 都 在 把 Quartz 及 Core Graphics 里 的 许多 特性 移植 到 UIKit， 使 开发 者 在 调整 文本 位 置 及 处 理 图 像 时 ， 
不 用 总 是 像 原 来 那样 反 转 y 轴 。 


4.7.5 ”坐标 系统 


早 前 说 过 ， 摘 述 视图 时 ， 可 以 采用 两 套 坐 标 系统 。frame 和 center 是 按照 上 级 视图 的 坐标 系 来 定义 的 ， 而 bounds 及 子 视 图 则 参照 当前 视图 的 坐标 系统 来 摘 述 。 只 
要 本 视图 和 其 上 级 视图 受 同 一 个 UIWindow 管 理 ， 我 们 融 能 用 iOs SDK 所 提供 的 许多 工具 方法 在 这 两 套 坐 标 系统 之 间 转 换 。convertPoint: fromView: FARR 
在 另 一 坐标 系 中 的 坐标 转换 成 它 在 本 坐标 系 里 的 坐标 。 例 如 : 


myPoint = [myView convertPoint:somePoint fromView:otherView]; 


假如 这 个 点 表示 某 对 象 的 位 置 ， 那 么 转换 之 后 的 点 坐标 依然 能 够 表示 位 置 ， 只 不 过 这 次 是 在 myView 的 角度 来 描述 位 置 的 。 与 该 方法 相反 ，convertPoint: 
toView: 方法 则 能 够 用 另 一 个 视图 的 坐标 系 来 描述 本 坐标 系 中 的 点 。convertRect: toView: 及 convertRect: fromView: 方法 的 功能 与 上 述 两 方法 相似 ， 它 们 适用 
于 CGRect 型 结构 体 ， 而 非 CGPoint 型 结构 体 。 


请 注意 ，iOs 设 备 的 坐标 系统 与 显示 该 系统 的 像素 系统 (pixel system) RUF. LUA, iPhone 4s 采 用 640x960 像 素 的 Retina 显 示 屏 ， 其 像素 是 离散 的 
(discrete) [1]， 而 SDK 却 使 用 320x480 的 连续 (continuous) 坐标 系统 来 表示 那些 像素 ， 此 系统 的 计量 单位 是 点 (point) 。 对 于 配 有 Retina 显 示 屏 的 设备 来 说 ， 尽 
管 开 友 者 可 以 用 高 质量 的 图 片 来 填充 那些 像素 ， 但 代码 中 以 点 为 单位 所 指定 的 坐标 其 坐标 系 依然 参照 的 是 像素 密度 较 低 的 设备 。 无 论 显示 屏 的 像素 密度 如 何 ， 对 于 显 


示 屏 为 3.5 英 时 的 iPhone 及 iPod touch 来 说 ， 屏 幕 中 心 点 的 坐标 大 概 都 是 (160.0, 240.0) 。 而 在 配 有 4 英 时 Retina 显 示 屏 的 iPhone 及 iPod touch 上 面向， 中 心 点 的 
坐标 则 是 (160.0, 284.0) 。 


Qi UISctreen 类 提供 了 名 为 scale 的 属性 ， 用 来 表示 显示 屏 的 像素 密度 与 点 坐标 系统 之 间 的 关系 。 通 过 该 属性 ， 我 们 可 以 把 视图 中 逻辑 坐标 系统 里 的 点 坐标 
(一 个 点 大 约 等 于 1/160 英 叶 ) 转换 成 设备 的 物理 像素 坐标 。 在 配 有 Retina 显 示 屏 的 设备 中 ，scale 值 是 2.0， 而 在 非 Retina 显 示 屏 的 设备 上 ， 则 是 1.0。 


[1] 大 意 是 像素 的 坐标 值 必 须 是 整数 ， 而 连续 的 意思 则 是 坐标 值 可 以 取 小 数 。 译 者 注 
[2] 这 种 设备 (比如 iPhone 5) 的 物理 像素 是 640 X1136， 而 开发 者 使 用 的 坐标 系 中 则 是 320 X568。 


译 者 注 


4.8 解决 方案 : 操控 视图 的 框架 


如 果 手 动 修改 了 视图 的 框架 ， 而 不 是 令 Auto Layout 机 制 自动 去 调整 的 话 ， 那 么 实际 上 就 等 于 改动 了 它 的 尺寸 (包含 宽度 和 高 度 ) 以 及 位 置 。 比 方 说 ,我 们 可 以 用 
下 列 代 码 来 移动 某 个 视图 的 框架 : 
CGRect initialRect = CGRectMake(0.0f, 0.0f, 100.0f, 100.0f); 


myView - [[UIView alloc] initWithFrame:initialRect]; 


[topView addSubview:myView]; 
myView.frame = CGRectMake(0.0f, 30.0f, 100.0f, 100.0f); 


上 述 代码 会 在 (0.0, 0.0) 点 创建 名 为 myView 的 子 视图 ， 然 后 将 其 移动 到 (0.0，30.0) 。 
这 种 移动 视图 的 方式 不 太 常 用 。iOS SDK 也 不 希望 开 友 者 通过 修改 frame 的 办 法 来 移动 视图 。 相 反 ， 它 关注 的 是 视图 的 位 置 。iOS 推 荐 的 视图 移动 方式 是 : 设置 视 
图 的 center 属 性 。 这 是 个 属于 UIView 的 属性 ， 我 们 可 以 直接 修改 它 的 值 : 


myView.center = CGPointMake(160.0f, 55.0f); 


你 可 能 认为 ，SDK 里 面 应 该 提供 了 一 种 通过 移动 原点 来 更 新 视图 位 置 的 方式 ,但 实际 上 它 没有 提供 。 不 过 我 们 只 需 针对 自己 的 视图 类 构建 category， 即 可 实现 此 
功能 。 把 视图 当前 的 frame 取 出 来 ， 将 所 需 的 点 设置 成 原点 (origin) ， 再 把 修改 后 的 CGRect 设 置 回 去 。 下 面 代码 可 以 为 我 们 自己 的 视图 类 创建 新 的 origin 属 性 ， 令 开 
发 者 可 以 由 此 来 获取 并 修改 视图 的 原 后 : 


(void)setOrigin: (CGPoint)aPoint 


CGRect newFrame - self.frame; 


newFrame.origin - aPoint; 
self.frame - newFrame; 


在 上 述 扩展 代码 中 ， 笔 者 使 用 了 origin (RA) KX RI ANIRAA, BUFRA REMI EMER" XR, BAXE CARERE 
为 名 称 重 复 (name overlap) 而 失效 。 本 书 的 范例 代码 经 常 使 用 这 种 常见 词汇 。 这 是 为 了 令 代码 更 容易 读 懂 ， 同 时 也 是 为 了 使 读者 能 够 更 快 地 理解 我 们 想 要 演示 的 概 
念 。 编 写真 正 的 应 用 程序 时 ， 不 要 使 用 这 种 容易 引 友 冲突 的 名 称 ， 而 是 应 该 将 你 的 姓名 或 公司 的 首 字母 缩写 当成 前 缀 ， 这 样 有 助 于 将 内 部 代码 同 其 他 代码 区 分 开 。 


移动 视图 对 象 时 ， 不 用 担心 曝露 出 来 或 隐藏 起 来 的 那些 矩形 区 域 ， 因 为 iOS 会 自动 把 视图 重新 绘制 好 。 开 友 者 只 需 把 视图 当成 可 以 来 回 操作 的 实际 物件 束 行 ， 绘 制 
问题 由 Cocoa Touch 处 理 。 


4.8.1 ”调整 视图 的 尺寸 


最 简单 的 一 种 用 法 就 是 通过 frame 和 bounds 来 控制 视图 的 尺寸 。 前 面 说 过 ，frame 是 以 上 级 视图 的 坐标 系 来 定义 视图 位 置 的 。 假 如 把 frame 的 原点 设 为 
(0.0, 30.0) ， 那 么 本 视图 的 左边 界 就 会 与 上 级 视图 对 齐 ， 而 上 边界 则 会 偏离 上 级 视图 顶端 30 个 点 。 在 非 Retina 显 示 屏 上 ， 这 相当 于 比 上 级 视图 的 顶端 低 了 30 个 像 
素 ， 而 在 Retina 显 示 屏 上 ， 则 低 了 60 像 素 。 

bounds 是 以 视图 自己 的 坐标 系 来 定义 的 。 因 此 ， 视 图 的 bpounds 属 性 ( 即 myView.bounds) 其 origin 一 般 都 是 (0.0, 0.0) 。 对 于 大 多 数 视图 来 说 ，bounds 的 宽 
和 高 都 与 视图 的 范围 相同 ， 也 就 是 和 frame 的 size 属 性 相同 。 (对 于 某 些 类 来 说 ， 则 通常 不 是 这 样 的 ， 例 如 ，UlscrollView 的 范围 就 可 能 会 超过 当前 可 以 显示 出 来 的 这 
一 部 分 。) 

调整 frame 或 bounds 属 性 即 可 修改 视图 的 尺寸 。 实 际 上 ， 我 们 修改 的 是 这 些 结构 体 里 面 的 size 字 段 。 与 实现 原点 移动 功能 时 所 用 的 办 法 类 似 ， 我 们 也 可 以 创建 一 
个 工具 方法 ， 令 开发 者 能 够 直接 修改 视图 尺寸: 


- (void)setSize: (CGSize)aSize 


| 


CGRect newbounds - self.bounds; 
newbounds.size - aSize; 
self.bounds = newbounds; 


如 果 某 个 视图 正 显示 在 屏幕 上 ， 而 开发 者 又 修改 了 它 的 尺寸 ， 那 么 系统 会 自动 更 新 该 视图 。 系 统 还 根据 视图 里 所 摆 放 的 UlI 元 件 以 及 视图 本 身 所 属 的 类 来 决定 是 对 
其 中 的 子 视图 进行 缩放 ， 还 是 移动 它们 的 位 置 ， 使 之 与 上 级 视图 的 新 尺寸 相符 ， 此 外 ， 系 统 也 有 可 能 会 裁 切 子 视图 的 可 视 范 围 。 具 体 做 法 取决 于 一 系列 标志 属性 的 取 
值 以 及 视图 是 否 处 在 Auto Layout 系 统 中 : 


- autotesizesSubviews 属 性 决定 了 当 视 图 的 bouhds 发 生变 化 时 ， 其 中 的 子 视 图 是 否 会 自动 缩放 。 


.autotesizingMask 属 性 决定 了 当 上 级 视图 的 bounds 有 变化 时 ， 本 视图 应 该 如 何 响 应 。 假 如 视图 处 在 约束 系统 之 中 ， 那 么 该 属性 表示 会 被 忽略 ，iOS 的 Auto Layout £i 
统 会 自动 调整 其 尺寸 。 


: clipsToBounds 标 志 决 定 了 系统 是 否 应 该 把 子 视 图 里 面 超出 本 视图 bounds 的 部 分 显示 出 来 。 如 果 开 启 了 此 标志 ， 那 么 系统 只 会 将 位 于 本 视图 bounds 之 内 的 部 分 子 视 
图 内 容 显 示 出 来 。 开 发 者 可 以 在 本 视图 上 面 调用 sizeToFit 方 法 ， 令 其 重新 调整 自身 大 小 ， 以 便 把 所 有 子 视图 都 党 括 进来 。 


contentMode 属 性 与 其 他 几 个 涉及 视图 缩放 的 属性 都 有 关联 ， 不 过 它 主 要 用 于 指明 视图 的 CALayet (也 就 是 其 内 容 位 图 (content bitmap) 在 bounds 发 生变 化 时 应 该 
如 何 调整 。 开 发 者 可 以 在 一 系列 包含 “缩放 . “居中 ”以 及 “ 自 适 应 ”的 选项 之 中 选 定 该 属性 的 取 值 ， 这 个 属性 一 般 是 在 操作 UIImageView 时 使 用 的 。 


Qi 视图 的 bounds 会 受到 transform 属 性 影响 ， 而 transform 是 个 用 于 改变 视图 显示 方式 的 数学 矩阵 。 假 如 要 通过 transform 来 调整 视图 的 样 貌 ， 那 么 就 不 要 同时 去 
操作 视图 的 frame 了， 否则 可 能 会 产生 不 符合 预期 的 结果 。 (本 章 稍 后 将 会 给 出 一 些 解决 办 法 。) 比方 说 ， 在 执行 了 变换 之 后 ，ftame 的 原点 在 数学 意义 上 可 能 就 和 
bounds 的 原点 不 相符 了 。 如 果 要 修改 视图 的 样 狐 ， 那 么 通常 的 操作 顺序 是 : 尽 可 能 先 修改 它 的 ftame 或 bounds， 然 后 设置 其 centet (中 心 点 ) ， 最 后 再 运用 ttansform (X 
换 ) 。 


有 的 时 候 ， 在 把 某 个 视图 添加 到 新 的 上 级 视图 之 前 ， 我 们 想 先 修改 其 大 小 。 比 方 说 ， 现 在 要 把 lImageView 放 到 AlertView 里 面 。 为 了 能 在 不 改变 宽 高 比 的 情况 下 把 
前 者 放 在 后 者 之 中 ， 我 们 可 调用 下 列 方法 ， 适 当地 缩小 视图 的 高 度 及 宽度 : 


- (void) fitInSize: (CGSize)aSize 


CGFloat scale; 

CGRect newframe = self.frame; 

if (newframe.size.height > aSize.height) 
scale = aSize.height / newframe.size.height; 
newframe.size.width *= scale; 
newframe.size.height *= scale; 

if (newframe.size.width > aSize.width) 
scale = aSize.width / newframe.size.width; 
newframe.size.width *= scale; 
newframe.size.height *= scale; 

self.frame = newframe; 


48.2 ”CGRect 与 中 心 点 


前 面 说 过 ，UIView 实 例 使 用 了 CGRect 结 构 体 ， 而 该 结构 体 中 包含 origin 及 size 字 段 ， 这 两 个 字段 用 来 定义 视图 的 frame。 我 们 无 法 通过 CGRect 结 构 体 直接 查询 中 
心 点 。 可 是 在 另 一 方面 ， 当 开发 者 移动 视图 的 时 候 ，UIView 却 要 依靠 其 center 属 性 来 把 自己 放 在 新 的 中 心 点 上 。 麻烦 的 地 方 在 于 ，Core Graphics 并 不 认为 中 心 点 是 
用 来 描述 矩形 的 主要 概念 ， 所 以 Core Graphics 里 内 置 的 函数 只 能 分 别 获 取 矩 形 中 心 点 在 x 轴 和 y 轴 方向 上 的 坐标 ， 而 不 能 直接 获取 这 个 中 心 点 。 


我 们 可 以 构建 一 种 消 数 ， 在 基于 原点 的 CGRect 结 构 体 和 基于 中 心 点 的 UIView 对 象 之 间 进 行 转换 。 用 矩形 中 心 点 的 x 坐标 值 和 y 坐 标 值 构 建 一 个 CGPoint， 即 可 实现 
此 函数 。 该 函数 接受 一 个 参数 ， 也 惑 是 矩形 ， 并 返回 其 中 心 点 : 


CGPoint CGRectGetCenter(CGRect rect) 


| 
CGPoint pt; 
pt.x - CGRectGetMidX (rect); 
pt.y = CGRectGetMidY (rect); 
return pt; 


| 
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后 的 视图 依然 处 在 上 级 视图 的 框架 之 内 。 为 了 在 移动 之 前 先 做 测试 ， 可 用 下 面 这 个 函数 模拟 一 下 当前 的 框架 在 视图 移动 到 新 的 中 心 点 之 后 会 位 于 何 处 : 


CGRect CGRectMoveToCenter(CGRect rect, CGPoint center) 


| 


CGRect newrect = CGRectZero; 

newrect.origin.x = center.x- (rect.size.width/2.0); 
newrect.origin.y = center.y-(rect.size.height/2.0); 
newrect.size - rect.size; 

return newrect; 


然后 ， 用 CGRectContainsRect() 函 数 判 断 移动 后 的 frame 与 上 级 视图 的 frame 之 间 是 何 关系 ， 以 此 确保 移动 后 的 视图 不 会 超出 其 容器 的 范围 。 


我 们 通常 需要 把 一 个 视图 放 在 另 一 视图 的 中 心 位 置 上 。 为 了 实现 居中 ， 可 以 把 本 视图 所 在 的 矩形 (subRect) 和 外 围 视图 所 在 的 矩形 (mainRect) 传 给 下 面 这 个 
负数 ， 以 获取 居中 后 的 矩形， 并 据 此 来 设 定 本 视图 的 位 置 。 假 如 要 把 本 视图 添加 成 外 围 视图 的 子 视图 ( 子 视 图 的 坐标 系 必须 从 (0, 0) 开始 ) , BEA mainRecte 3s 
应 该 是 外 围 视 图 的 bounds; 若 要 令 本 视图 从 属于 外 围 视图 的 上 级 视图 ， 那 么 mainRect 参 数 束 应 该 是 外 围 视 图 的 frame: 


CGRect CGRectCenteredInRect(CGRect subRect, CGRect mainRect) 


人 


CGFloat xOffset = CGRectGetMidX (mainRect) -CGRectGetMidX(subRect); 
CGFloat yOffset = CGRectGetMidY (mainRect) -CGRectGetMidY (subRect); 
return CGRectOffset(rect, xOffset, yOffset); 


48.3 ”视图 的 其 他 几何 特征 


正如 大 家 在 前 面 看 到 的 那样 ， 我 们 可 以 给 视图 添加 origin 及 size 属 性 ， 使 开发 者 能 够 像 使 用 center 属 性 那样 来 使 用 这 些 属性 ， 以 便 更 好 地 同 Core GraphicsEBBSEs 
数 相 集成 。 用 相似 的 方式 ， 还 可 以 把 包括 width (宽度 ) 及 height (SE) 在 内 的 其 他 属性 曝露 给 开发 者 ， 另 外 ， 也 可 以 提供 以 点 为 计量 单位 的 left (左边 界 ) 、 
right (右边 界 ) 、top (上 边界 ) 、bottom (下 边界 ) 等 基本 几何 特征 。 从 某 种 程度 上 来 看 ， 这 与 苹果 公司 的 设计 风格 不 符 。 苹 果 公 司 的 风格 是 在 不 曝露 底层 结构 体 
的 实现 细节 这 一 前 提 下 ， 把 其 中 某 些 特征 提供 给 开发 者 使 用 。 但 从 另 一 个 角度 来 看 ， 我 们 也 可 以 说 ， 上 面 提 到 的 那些 width、height、left 等 本 身 就 应 该 设计 成 UIView 
的 属性 。 因 为 它们 确实 反映 了 视图 的 一 些 基 本 特征 ， 所 以 理应 作为 属性 提供 给 开发 者 来 使 用 。 


解决 方案 4-4 针 对 UIView 类 编写 了 名 为 ViewFrameGeometry 的 category， 并 提供 了 一 整套 与 frame 有 关 的 工具 ， 而 读者 可 以 自己 来 决定 是 否 将 这 些 属 性 公布 出 
来 。 该 category 中 的 属性 值 都 没有 考虑 transform (变换 ) 。 


Qi 有 了 Auto Layout 机 制 之 后 ， 这 个 category 中 的 许多 工具 方法 都 显得 不 那么 重要 了 ， 不 过 它们 仍然 很 有 价值 ， 因 为 有 的 时 候 ， 你 必须 手工 指定 视图 布局 ， 其 
至 在 使 用 了 Auto Layout 的 情况 下 ， 偶 尔 也 还 是 会 用 到 它们 的 。 


解决 方案 4-4 在 UIView 的 category 中 添加 与 frame 几 何 特征 有 天 的 属性 


@interface UIView (ViewFrameGeometry) 
@property CGPoint origin; 
Gproperty CGSize size; 


@property (readonly) CGPoint midpoint; 


// topLeft is synonymous with origin so not included here 
@property (readonly) CGPoint bottomLeft; 

@property (readonly) CGPoint bottomRight; 

@property (readonly) CGPoint topRight; 


@property CGFloat height; 
@property CGFloat width; 
@property CGFloat top; 
@property CGFloat left; 
@property CGFloat bottom; 
@property CGFloat right; 


- (void) moveBy: (CGPoint) delta; 

- (void) scaleBy: (CGFloat)scaleFactor; 
= (void) fitInSize: (CGSize) aSize; 

@end 


@implementation UIView (ViewGeometry) 
// Retrieve and set the origin 
- (CGPoint) origin 


{ 


return self.frame.origin; 


- (void) setOrigin: (CGPoint) aPoint 
CGRect newFrame = self.frame; 
newFrame.origin = aPoint; 
self.frame = newFrame; 


// Retrieve and set the size 
- (CGSize) size 


{ 


return self.frame.size; 


- (void) setSize: (CGSize) aSize 
CGRect newFrame = self.frame; 
newFrame.size = aSize; 
self.frame = newFrame; 


// Query other frame locations 


- (CGPoint)midpoint 

{ 
// midpoint is with respect to a view's own coordinate system 
// versus its center, which is with respect to its parent 
CGFloat x CGRectGetMidx (self .bounds) ; 
CGFloat y = CGRectGetMidyY (self.bounds) ; 
return CGPointMake (x, y); 


- (CGPoint)bottomRight 


{ 


CGFloat x = self.frame.origin.x + self.frame.size.width; 


CGFloat y = self.frame.origin.y + self.frame.size.height; 
return CGPointMake(x, y); 


- (CGPoint) bottomLeft 

{ 
CGFloat x = self.frame.origin.x; 
CGFloat y = self.frame.origin.y + self.frame.size.height; 
return CGPointMake(x, y); 


(CGPoint) topRight 


CGFloat x = self.frame.origin.x + self.frame.size.width; 
CGFloat y = self.frame.origin.y; 
return CGPointMake(x, y); 


// Retrieve and set height, width, top, bottom, left, right 
- (CGFloat) height 


{ 


return self.frame.size.height; 


(void) setHeight: (CGFloat) newHeight 


CGRect newFrame = self.frame; 
newFrame.size.height = newHeight; 
self.frame = newFrame; 


- (CGFloat) width 


{ 


return self.frame.size.width; 


- (void) setWidth: (CGFloat)newWidth 
CGRect newFrame = self.frame; 
newFrame.size.width = newWidth; 
self.frame = newFrame; 


- (CGFloat) top 
{ 


{ 


return self.frame.origin.y; 


(void) setTop: (CGFloat) newTop 
CGRect newFrame = self.frame; 
newFrame.origin.y = newTop; 
self.frame = newFrame; 


(CGFloat) left 


return self.frame.origin.x; 


(void) setLeft: (CGFloat) newLeft 
CGRect newFrame = self.frame; 
newFrame.origin.x = newLeft; 
self.frame = newFrame; 


(CGFloat) bottom 


return self.frame.origin.y + self.frame.size.height; 


(void) setBottom: (CGFloat) newBottom 
CGFloat delta = newBottom - 
(self.frame.origin.y + self.frame.size.height) ; 
CGRect newFrame = self.frame; 
newFrame.origin.y += delta; 
self.frame = newFrame; 


(CGFloat) right 


return self.frame.origin.x + self.frame.size.width; 


(void)setRight: (CGFloat)newRight 


CGFloat delta = newRight- 
(self.frame.origin.x + self.frame.size.width); 
CGRect newFrame - self.frame; 
newFrame.origin.x += delta; 
self.frame - newFrame; 


@end 


4.9 解决 方案 : NABCSABENSEIRR ABI EA 


通过 仿 射 变换 ， 我 们 可 以 把 视图 对 象 从 一 个 坐标 系 变 换 到 另 一 个 坐标 系 ， 从 而 改变 其 几何 特征 。iOS SDK 完 全 支持 标准 的 二 维 仿 射 变换 。 开 发 者 可 以 按照 自己 的 想 
法 和 应 用 程序 的 需求 ， 对 视图 进行 缩放 、 平 移 、 旋 转 、 斜 切 (skew) 等 操作 。 


变换 机 制 是 定义 在 Core Graphics 里 面 的 ，Core Graphics 提 供 了 诸如 CGAffineTransform-MakeRotation(0 及 CGAffineTransformscale( 等 函数 。 它 们 可 以 构建 
并 修改 3x3 的 变换 和 矩阵。 构建 好 和 矩阵 之 后 ， 利 用 UIView 的 transform 属 性 ， 可 以 在 UIView 对 象 上 面 实施 二 维 仿 射 变换 。 


例如 ， 我 们 可 以 直接 用 transform 属 性 来 实现 旋转 。 这 样 做 会 移 除 现 有 的 变换 矩阵 ， 并 代 之 以 简单 的 旋转 效果 。 名 称 中 含有 Make 一 词 的 函数 会 创建 出 新 的 变换 和 矩 
阵 : 


theView.transform = CGAffineTransformMakeRotation(radians); 
Ay, tEHILACEXVSBSaSUERIZ E, SHE. T-ERBARIBMake—isBJERgZmLASS—^- 25247328, TRIEEUSSCKIEISEHRWUR, HEERE 
返回 给 调用 者 : 


CGAffineTransform scaled = CGAffineTransformScale (theView.transform, 
scaleX, scaleY); 
theView.transform - scaled; 


49.1 获取 与 变换 有 天 的 属性 


在 操作 transform 的 时 候 ，iOs 会 以 仿 射 得 阵 来 表示 视图 的 变换 效果 。 这 种 表示 形式 并 不 会 直接 告诉 你 视图 要 缩放 多 少 倍 或 旋转 多 少 度 。 于 是 ， 我 们 在 解决 方案 4-5 
里 针对 UIView 编 写 category， 并 在 这 个 简单 的 category 里 面 算出 具体 的 缩放 倍数 和 旋转 角度 。 


iOs 用 六 个 字段 来 表示 仿 射 阵 ， 它 们 分 别 是 as、b、c、d、tx 及 ty。 图 4-4 演 示 了 这 些 值 在 标准 仿 射 矩阵 里 的 位 置 。 解 决 方案 4-5 采 用 简单 的 数学 算式 ， 根 据 这 些 字 
入 算出 缩放 倍数 和 旋转 角度 。 从 图 4-4 中 可 以 看 出 ， 和 矩阵 里 的 tx 值 和 ty 值 直接 对 应 于 仿 射 变换 的 平移 量 。 即 便 读 者 不 擅长 线性 代数 也 没有 关系 ， 因 为 就 算 不 理解 变换 的 
原理 ,我们 也 依然 能 用 它 实现 出 相关 的 效果 来 。 


在 回答 “视图 现在 旋转 了 多 少 度 ? ”以 及 “缩放 倍数 是 多 少 ? ”等 问题 之 前 ,我 们 一 般 要 通过 数学 运算 ， 把 视图 在 变换 之 后 的 几何 特征 同 其 上 级 视图 的 坐标 系统 
关联 起 来 。 要 想 实 现 这 一 目标 ， 得 先 想 个 办 法 来 指定 视图 在 屏幕 上 面 的 位 置 才 行 。 


图 4-4 CGAffineTransform 25 44] 4 E vi PR ZEE AT 4. EAR BLUR 69 48 ER, KERR RMT AMA, HDGRAUSRAREE Y $48 XCUAE (如 左 侧 小 图 所 示 ) 。 运 用 了 仿 射 变换 
之 后 ， 视 图 的 origin (原点 ) 可 能 就 和 frame 的 ofigin 不 重合 了 (如 右 侧 小 图 所 示 ) 


明确 了 视图 的 中 心 点 ， 我 们 融 可 以 放心 地 执行 变换 了 。 这 个 中 心 点 的 值 可 能 会 变 ， 尤 其 是 执行 完 缩放 变换 乙 后 更 是 如 此 ， 然 而 ， 无 论 我 们 对 视图 执行 了 何 种 变 
换 ， 该 属性 的 值 依 然 是 比较 有 用 的 。 这 个 center 属 性 总 是 对 应 于 frame 的 几何 中 心 ， 它 表示 几何 中 心 在 上 级 视图 坐标 系 里 的 位 置 。 


而 视图 的 frame 则 不 那么 有 用 。 因 为 旋转 之 后 ， 视 图 的 origin 可 能 就 和 frame 的 origin 完 全 无 关 了 。 通 过 图 4-4 右 侧 的 小 图 可 以 看 出 这 一 点 。 实 心 菱形 就 是 旋转 后 的 
视图 ， 它 背后 有 两 条 外 框 线 ， 其 中 范围 较 小 的 一 条 表示 旋转 之 前 的 frame， 而 范围 较 大 的 一 条 则 表示 旋转 之 后 的 frame。 两 个 红色 小 圆圈 分 别 表 示 视 图 在 旋转 之 前 和 旋 
转 之 后 的 origin。 


运用 了 变换 效果 之 后 ， 系 统 就 会 把 frame 修 改 成 能 够 容纳 该 视图 的 最 小 边界 框 (minimum bounding box) 。frame 的 新 origin (也 就 是 大 外 框 线 的 左上 角 ) 与 
视图 的 新 origin (也 就 是 正 上 方 的 那个 小 圆圈 ) 实际 上 已 经 没什么 关系 了 。iOSs 没 有 向 开发 者 提供 一 些 手段 ， 令 其 可 以 查询 调整 之 后 的 点 。 


解决 方案 4-5 实 现 了 几 个 方法 ， 可 以 代替 开发 者 来 完成 这 些 数 学 运算 。 它 会 算出 视图 在 执行 完 变换 之 后 其 四 个 角 分 别 位 于 何 处 ， 并 通过 相关 属性 把 这 一 结果 提供 给 
开发 者 。 这 些 坐 标 都 是 以 上 级 视图 为 参照 物 的 。 图 4-4 右 侧 的 那 幅 小 图 其 正 上 方 有 个 红色 圆圈 ， 如 果 我 们 要 把 一 个 新 的 视图 放 在 这 个 圆圈 上 面 ， 那 么 可 将 其 center 设 为 


theView.transformedTopLeft, 


这 个 解决 方案 里 还 提供 了 originalFrame 方 法 ， 无 论 视图 有 没有 运用 变换 效果 ， 它 都 会 返回 本 来 的 frame， 也 就 是 图 4-4 中 范围 较 小 的 外 框 线 。 笔 者 是 用 一 种 非 


常 “ 条 ”的 办 法 把 它 算出 来 的 ， 不 过 这 个 办 法 确实 可 行 。 


4.9.2 ”判断 两 个 视图 是 否 相 交 


应 读者 请 求 ， 笔 者 又 在 解决 方案 4-5 里 面 写 了 一 些 代码 ， 用 以 判断 两 个 变换 后 的 视图 是 否 相 交 。 对 于 没有 施加 变换 效果 的 视图 来 说 ， 这 些 代码 依然 适用 ， 所 以 实际 
上 它 可 以 用 于 任何 视图 ， 只 不 过 ， 在 未 施加 变换 效果 的 情况 下 ， 这 样 做 意义 不 大 ， 因 为 我 们 可 以 直接 用 CGRectintersectsRect(0) 函 数 来 判断 两 者 的 frame 是 否 相 交 。 笔 
者 上 自 编 的 这 段 代 码 非 常 适合 用 来 检测 那 种 外 观 与 底层 几何 结构 不 相符 的 视图 ， 比 如 图 4-4 里 的 那 种 。 


解决 方案 4-5 ”获取 与 坐标 变换 有 天 的 值 


@implementation UIView 


(CGFloat)xScale 
CGAffineTransform t 
return sqrt(t.a * t 

(CGFloat)yScale 
CGAffineTransform t 
return sqrt(t.b * t 

(CGFloat)rotation 
CGAffineTransform t 


return atan2f (t.b, 


(CGFloat)tx 


(Transform) 


a 


b 


self.transform; 
4 cho * Ee) s 


self.transform; 
4&6 t.d * td); 


self.transform; 


Bals 


CGAffineTransform t 


return Eta 


(CGFloat)ty 


CGAffineTransform t 


return tty; 


self.transform; 


self.transform; 


// The following three methods move points into and out of the 


// transform coordinate system whose origin is at the view center 


(CGPoint)offsetPointToParentCoordinates: (CGPoint)aPoint 


return CGPointMake(aPoint.x + self.center.x, 
aPoint.y + self.center.y); 


(CGPoint)pointInViewCenterTerms: (CGPoint)aPoint 


return CGPointMake(aPoint.x - self.center.x, aPoint.y - self.center.y); 


(CGPoint)pointInTransformedView: (CGPoint)aPoint 


CGPoint offsetItem 


[self pointInViewCenterTerms:aPoint] ; 


CGPoint updatedItem = CGPointApplyAffineTransform( 
offsetItem, self.transform); 
CGPoint finalItem = 
[self offsetPointToParentCoordinates:updatedItem] ; 
return finallItem; 


// Return the original frame without transform 
- (CGRect) originalFrame 
{ 
CGAffineTransform currentTransform = self.transform; 
self.transform = CGAffineTransformIdentity; 
CGRect originalFrame = self.frame; 
self.transform = currentTransform; 


return originalFrame; 


// These four methods return the positions of view elements 
// with respect to the current transform 


(CGPoint) transformedTopLeft 


CGRect frame = self.originalFrame; 
CGPoint point = frame.origin; 
return [self pointInTransformedView: point] ; 


- (CGPoint)transformedTopRight 


CGRect frame = self.originalFrame; 

CGPoint point = frame.origin; 

point.x += frame.size.width; 

return [self pointInTransformedView:point] ; 


(CGPoint) transformedBottomRight 


CGRect frame = self.originalFrame; 

CGPoint point = frame.origin; 

point.x += frame.size.width; 

point.y += frame.size.height; 

return [self pointInTransformedView: point] ; 


- (CGPoint)transformedBottomLeft 


CGRect frame = self.originalFrame; 


CGPoint point = frame.origin; 
point.y += frame.size.height; 


return [self pointInTransformedView:point]; 


// Determine if two views intersect, with respect to any 
// active transforms 


// After extending a line, determine which side of the half 
// plane defined by that line, a point will appear 
BOOL halfPlane(CGPoint pi, CGPoint p2, CGPoint testPoint) 
| | 
CGPoint base = CGPointMake(p2.x - pl.x, p2.y - pl.y); 
CGPoint orthog = CGPointMake(-base.y, base.x); 
return (((orthog.x * (testPoint.x - pl.x)) + 
(oOrthog.y * (testPoint.y = pl.y))) >= 0); 


// Utility test for testing view points against a proposed line 

BOOL intersectionTest (CGPoint pl, CGPoint p2, UIView *aView) 

{ 
BOOL tlTest 
BOOL trTest 
if (tlTe8t | 


halfPlane(pl, p2, aView.transformedTopLeft); 
halfPlane(pl, p2, aView.transformedTopRight) ; 
trTest) return YES; 


BOOL brTest 
if (tlTest ! 


halfPlane(pl, p2, aView.transformedBottomRight) ; 
brTest) return YES; 


BOOL blTest = halfPlane(pl, p2, aView.transformedBottomLe ft) ; 
if (tlTest != blTest) return YES; 


return NO; 


// Determine whether the view intersects a second view 
// with respect to their transforms 
- (BOOL) intersectsView: (UIView *)aView 


{ 


if (!CGRectIntersectsRect(self.frame, aView.frame)) return NO; 
CGPoint A - self.transformedTopLeft; 

CGPoint B - self.transformedTopRight; 

CGPoint C - self.transformedBottomRight; 

CGPoint D - self.transformedBottomLeft; 

if (!intersectionTest/(A, B, aView)) 


{ 


BOOL test = halfPlane(A, B, aView.transformedTopLeft) ; 
BOOL tl = halfPlane(A, B, C); 

BOOL t2 halfPlane(A, B, D); 

if ((tl != test) && (t2 != test)) return NO; 


if (!intersectionTest(B, C, aView)) 


| 


BOOL test - halfPlane(B, C, aView.transformedTopLeft); 


BOOL t1 = halfPlane(B, C, A); 
BOOL t2 = halfPlane(B, C, D); 
if ((tl1 != test) && (t2 != test)) return NO; 


} 


if (!intersectionTest(C, D, aView)) 


{ 


ROOT. treat = halfPlane(C. D. aView rran«eformed'ToenT.efr»: 
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BOOL t1 = halfPlane(C, D, A); 

BOOD t2 - halfPlane(C, D, B); 

if ((tl != test) && (t2 != test)) return NO; 
} 
if (!intersectionTest(D, A, aView) ) 


| 


BOOL test - halfPlane(D, A, aView.transformedTopLeft); 
BOOL tl = halfPlane(D, A, B); 

BOOL t2 - halfPlane(D, A, C); 

if ((tl1 != test) && (t2 != test)) return NO; 


aView.transformedTopLeft; 
aView.transformedTopRight; 


aView.transformedBottomRight; 
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aView.transformedBottomLeft; 


if (!intersectionTest(A, B, self)) 


{ 


BOOL test = halfPlane(A, B, self.transformedTopLeft) ; 


BOOL t1 = halfPlane(A, B, C); 

BOOL t2 - halfPlane(A, B, D); 

if ((tl != test) && (t2 != test)) return NO; 
} 
if (1!intersectionTest(B, C, self)) 


{ 


BOOL test = halfPlane(B, C, self.transformedTopLeft) ; 


BOOL t1 = halfPlane(B, C, A); 

BOOL t2 = halfPlane(B, C, D); 

if ((tl != test) && (t2 != test)) return NO; 
j 
if (lintersectionTest(C, D, self)) 


| 


BOOL test - halfPlane(C, D, self.transformedTopLeft); 


BOOL t1 = halfPlane(C, D, A); 

BOOL t2 - halfPlane(C, D, B); 

if ((tl != test) && (t2 != test)) return NO; 
} 
if (!intersectionTest(D, A, self) ) 


{ 


BOOL test = halfPlane(D, A, self.transformedTopLe ft) ; 


BOOL t1 = halfPlane(D, A, B); 
BOOL t2 - halfPlane(D, A, C); 
if ((tl != test) && (t2 !- test)) return NO; 


return YES; 


| 


@end 


intersectsView: 方法 采用 凸 多边 形 (convex polygon) 的 分 离 轴 算 法 (axis separation algorithm) 来 判断 两 者 是 否 相 交 。 我 们 轮流 测试 每 个 视图 的 每 条 边 ， 
如 果 发 现 其 中 一 个 视图 的 所 有 点 都 在 该 边 的 一 人 出， 而 另 一 个 视图 的 所 有 点 都 位 于 该 边 的 另 一 出， 那么 两 视图 就 不 相交 。 这 一 测试 是 基于 halfPlane 方 法 而 实现 的 ， 该 方 
法 的 返回 值 表示 给 定 的 点 是 在 某 条 边 的 左 侧 还 是 在 其 右 侧 。 


假如 找到 了 满足 此 条 件 的 边 ， 那 么 intersectsView : 方法 就 返回 NO。 如 果 有 条 线 能 够 把 一 个 视图 里 的 所 有 点 都 划分 到 它 的 一 侧 ， 而 将 另 一 个 视图 里 的 所 有 点 都 划 
分 到 它 的 另 一 侧 ， 那 么 这 两 个 视图 就 不 可 能 相交 。 


假如 8 次 测试 都 失败 了 (针对 第 一 个 视图 的 4 条 边 做 4 次 测试 ， 再 针对 第 二 个 视图 的 4 条 边 做 4 次 测试 ) ， 那 么 该 方法 束 认 为 两 个 视图 确实 相交 ， 它 会 返回 YES。 


4.10 ”与 显示 和 交互 有 关 的 特征 


除了 在 屏幕 上 的 物理 布局 之 外 ，UlView 类 还 提供 了 一 些 属性 ， 用 于 控制 视图 的 样 驾 以 及 用 户 是 否 可 以 操作 此 视图 。 视 图 的 alpha 值 可 以 在 完全 不 透明 与 完全 透明 
之 间 变 化 。 调 用 [myView setAlpha: value] 语 句 或 是 设置 myView.alpha 属 性 ， 都 可 以 调整 此 值 。alpha 的 取 值 沁 围 是 0.0 到 1.0，0.0 表 示 完 全 透明 ，1.0 表 示 完 全 不 透 
明 。 用 alpha 值 来 实现 视图 的 淡 入 淡出 效果 是 个 非常 好 的 办 法 。 如 果 想 令 视图 不 经 动画 效果 就 直接 消失 ， 那 么 请 使 用 hidden 属 性 。 


开发 者 可 以 指定 任意 视图 的 背景 色 。 例 如 ， 可 以 通过 backgroundColor 属 性 将 视图 的 背景 变 红 : 


myView.backgroundColor = [UIColor redColor] ; 


这 个 属性 对 不 同类 型 的 视图 所 造成 的 影响 是 不 同 的 ， 具 体 要 看 视图 里 面 有 没有 挡住 背景 色 的 子 视图 。 把 视图 的 背景 色 设 为 [U1Color clearColor]， 即 可 创建 出 透明 


A 


ac 
F3 
myView.backgroundColor - [UIColor clearColor]; 


每 个 视图 都 提供 了 backgroundColor 属 性 ， 无 论 用 户 到 底 能 不 能 看 见 这 个 视图 ， 开 发 者 都 可 以 操作 该 属性 。 使 用 鲜亮 而 且 反 差 较 大 的 背景 色 ， 可 以 非常 有 力 地 呈 
现 出 视图 的 真正 内 容 。 对 于 初学 iOS 开 上 友 的 读者 来 说 ， 可 以 通过 调整 视图 颜色 来 判明 哪些 内 容 显示 在 屏幕 上 ， 哪 些 内 容 没有 显示 出 来 ， 也 可 以 明确 每 个 组 件 的 位 置 。 


并 非 每 种 颜色 都 是 纯色 。 我 们 可 以 像 使 用 纯色 那样 通过 UIColor 类 来 使 用 平 铺 的 纹样 (tiled pattern) 。colorWithPatternImage: 方法 会 根据 开 友 者 所 提供 的 图 
像 返 回 UIColor 实 例 。 该 方法 很 适合 用 来 构建 演 染 视图 时 所 用 的 材质 (texture) 。 


userlnteractionEnabled 属 性 用 来 控制 用 户 能 否 触 摸 并 操作 某 个 特定 的 视图 。 对 于 大 多 数 视图 来 说 ， 这 个 属性 的 默认 值 是 YES。 而 对 于 UllmageView 来 说 ， 它 的 
默认 值 则 是 NO， 这 把 很 多 初学 者 都 给 难 住 了 。 他 们 通常 会 用 UllmageView 来 填 满 整个 程序 界面 ， 并 在 上 面 放置 开关 、 文 本 框 以 及 按钮 等 控件 ， 然 后 却 发 现 用 户 无 法 
操作 这 些 控件 。 如 果 某 个 视图 的 子 视图 (这些 子 视图 包括 按钮 、 开 关 、 选 取 器 以 及 其 他 控件 ) 需要 接受 触摸 ， 那 么 一 定 要 先 局 用 该 属性 才 行 。 要 是 发 现 某 个 控件 似乎 
无 法 响应 触摸 ， 那 么 请 检查 该 控件 及 其 上 级 控件 的 userlnteractionEnabled 属 性 值 。 


如 果 要 在 可 供用 户 操 作 的 区 域 里 放置 一 种 仅 用 于 显示 的 视图 ， 那 么 可 以 禁用 这 个 属性 。 比 方 说 ,我们 要 通过 透明 的 全 屏 视 图 在 屏幕 上 蔷 放 一 个 不 能 接受 用 户 操 作 
的 时 钟 ， 那 么 ， 就 可 以 把 userinteractionEnabled 标 志 设 为 NO， 使 得 用 户 无 法 去 操作 它 。 这 样 一 来 ， 用 户 的 触摸 操作 束 会 穿 过 这 个 透明 的 视图 而 到 达 它 背后 的 那 块 区 
域 ， 那 块 区 域 正 是 应 用 程序 里 可 以 接受 实际 操作 的 区 域 。 把 userlnteractionEnabled 标 志 设 为 NO 只 能 令 该 视图 本 身 不 接收 触摸 操作 ， 而 这 些 触摸 操作 仍然 可 以 穿 过 本 
视图 ， 到 达 它 背后 的 其 他 视图 。 如 果 要 在 屏幕 上 创建 一 种 提示 用 户 等 待 的 图 案 ， 以 阻止 其 操作 应 用 程序 ， 那 么 请 把 该 图 案 的 userlnteractionEnabled 标 志 打 开 ， 使 它 
能 够 将 用 尸 的 所 有 触摸 操作 都 拦截 下 来 ， 从 而 令 其 无 法 达到 图 案 背 后 的 主 界面 。 


切换 视图 的 时 候 ， 也 可 以 禁用 该 标志 ， 以 确保 程序 在 播放 切换 动画 的 过 程 中 ， 不 会 因为 用 尸 的 点 击 操作 而 触 友 相关 的 动作 。 对 于 游戏 和 解 迹 类 的 程序 来 说 ， 时 机 
不 当 的 触摸 操作 可 能 会 令 程序 出 问题 。 


4.11 UlView 的 动画 效果 


在 针对 iOS 平 台 做 开发 时 ，UlView 的 动画 效果 是 个 有 点 俏皮 的 东西 。 更 新 视图 的 时 候 ， 我 们 可 以 用 一 种 运动 的 形式 把 视图 内 容 变 化 的 过 程 表 现 出 来 ， 从 而 产生 流 
畅 的 动画 效果 ， 并 提升 程序 的 用 尸体 验 。 动 画 效 果 最 明显 的 优势 在 于 ， 无 须 编写 多 少 代 码 ， 融 可 将 其 实现 出 来 。 


UIView 的 动画 效果 可 以 令 用 户 清 林地 看 到 视图 是 号 样 从 当前 状态 切换 到 另 一 种 状态 的 。 实 现 动画 效果 时 ， 我 们 天 注 的 是 视图 的 内 容 会 有 哪些 变化 ， 以 及 如 何 把 动 
圆 效 果 与 这 些 变 化 联系 起 来 。 可 以 用 动画 效果 来 表现 下 列 变 化 过 程 : 


位 置 变 化 一 一 通过 移动 其 中 心 点 而 改变 视图 在 屏幕 上 的 位 置 。 


. 尺寸 变化 一 一 通过 修改 视图 的 frame 和 bounds 而 改变 视图 的 尺寸 。 


. 可 拉 伸 范围 的 变化 一 一 通过 视图 的 contentSttetch 属 性 来 改变 视图 内 容 里 可 供 拉 伸 的 区 域 。 


- 透明 度 变 化 一 一 改变 视图 的 alpha 值 。 
- 颜色 变化 一 一 修改 视图 的 背景 色 。 
- 旋转 角度 、 缩 放 倍数 、 平 移 量 的 变化 一 一 基本 上 相当 于 对 视图 运用 仿 射 变换 。 


在 SDK 从 3.x 版 演化 到 4.x 版 的 过 程 中 ， 苹 果 公 司 彻底 重 制 了 动画 效果 。 从 4.x 版 本 起 ， 开 发 者 就 可 以 使 用 Objective-C 的 块 来 简化 动画 代码 了 ， 这 是 一 种 新 的 编程 范 
式 。 虽 说 原来 那 套 实现 动画 效果 的 技术 依然 可 以 使 用 ， 但 是 新 的 方式 要 简单 许多 ， 而 且 苹 果 公 司 的 开发 文档 也 专门 说 明 : 不 推荐 及 用 老式 的 做 法 来 实现 动画 效果 。 


Qi 苹果 公司 自己 制作 的 大 多 数 动画 的 长 度 都 在 三 分 之 一 或 二 分 之 一 秒 左 右 。 在 设计 辅助 视图 (helper view， 也 就 是 起 支持 作用 的 视图 ， 它 们 与 苹果 公司 的 
键盘 或 警告 界面 相似 ) 的 动画 效果 时 ， 开 发 者 可 以 令 自 己 的 动画 长 度 与 系统 自 带 的 动画 长 度 相仿 。 调 用 [UIApplication statusBarOrientationAnimationDuration], ， 即 可 得 知 
标准 的 动画 时 长 。 


用 块 来 构建 动画 效果 


用 块 来 创建 动画 效果 ， 可 以 减少 所 需 编 写 的 代码 量 。 下 面 这 段 代 码 只 用 了 一 行 语句 融 实 现 了 视图 的 淡出 效果 ， 语 句 里 面 众 套 了 一 个 块 : 


[UIView animationWithDuration: 1.0f 
animations:*{contentView.alpha = 0.0f;}]; 


我 们 可 以 通过 completion 参 数 传 入 一 个 块 ， 以 便 在 动画 结束 之 后 执行 清理 工作 。 下 面 这 段 代码 会 对 contentView 运 用 淡出 效果 ， 并 且 会 在 动画 结束 之 后 ， 将 其 从 
上 级 视图 里 移 除 : 


[UIView animationWithDuration: 1.0f 
animations:^(contentView.alpha = 0.0f;} 
completion:^(BOOL done) { [contentView removeFromSuperview];]]; 


如 果 还 想 为 动画 效果 指定 一 些 选项 ， 那 么 可 以 通过 全 能 的 animateWithDuration: delay: options: animations: completion: 方法 来 做 ， 该 方法 也 是 基于 块 
的 ， 开 发 者 既 可 以 传 入 掩 码 形式 的 动画 选项 ， 又 可 以 指定 动画 的 延迟 ( 若 想 连续 播放 好 几 段 动画 效果 ， 则 可 以 考虑 为 它们 指定 不 同 的 delay 值 ， 这 是 一 种 比较 简单 的 实 
现 方 式 ) 。 


使 用 与 动画 有 关 的 常量 时 ， 记 得 要 选用 名 称 里 带 有 Options 一 词 的 新 版 UIView-AnimationOptions 常 量 ， 而 不 要 使 用 UlIViewAnimationCurveEaselnOut 等 旧版 
常量 ， 在 4.x 及 以 后 的 iOS 系 统 里 ， 这 些 常量 无 法 使 相关 的 方法 正常 运作 。 


在 个 别 情况 下 ， 我 们 想 把 某 属性 的 变化 排除 在 动画 效果 之 外 ， 但 有 时 候 却 无 法 确定 视图 的 这 个 属性 会 在 何 处 发 生变 化 。 比 方 说 ， 开 发 者 在 自己 创建 的 块 里 面 编写 
了 一 段 动画 代码 ， 而 这 段 代 码 修改 了 我 们 不 想 对 其 运用 动画 效果 的 那个 属性 ， 或 者 iOs 系 统 所 提供 的 某 些 方法 会 修改 这 个 属性 ， 而 该 属性 恰好 又 用 在 了 在 某 个 动画 
块 [里 面 。 在 这 些 情 况 下 ， 我 们 就 急需 一 种 手段 ， 能 够 将 该 属性 从 动画 效果 中 排除 掉 。 在 iOS 7 中 ， 苹 果 公司 给 UIView 类 提供 了 performWithoutAnimation : 方法 ， 
它 和 animationWithDuration 类 似 ， 也 接受 块 作 参 数 。 凡 是 在 这 个 块 里 发 生变 化 的 属性 都 会 排除 在 动画 效果 之 外 ， 即 便 我 们 在 另 一 个 封装 好 的 动画 块 里 修改 了 该 属 
性 ， 它 也 不 会 具备 动画 效果 。 


[1] 也 就 是 传 给 animateWithDuration 方 法 animations 参 数 的 那个 块 ， 其 中 会 包含 一 些 修改 视图 属性 的 语句 ， 用 以 实现 动画 效果 ， 而 传 给 completion 参 数 的 那个 块 则 称 为 完成 


块 ， 该 块 中 的 语句 将 会 在 动画 效果 结束 之 后 执行 。 译 者 注 


4.12 解决 方案 : 视图 的 淡 入 与 淡出 


有 时 候 ， 我 们 要 在 屏幕 中 现 有 的 视图 前 方 显示 一 些 信息 ， 这 些 信息 本 身 只 起 提示 作用 ， 并 没有 别 的 用 途 。 比 方 说 ， 我 们 要 显示 高 分 榜 、 用 法 说 明 ， 或 是 提供 与 情 
境 相 天 的 提示 语 。 解 决 方案 4-6 用 块 实 现 了 两 段 UIView 动 画 效果 ， 可 以 分 别 令 视图 逐渐 显示 出 来 ， 或 慢 慢 消失 。 该 解决 方案 采用 最 基本 的 方式 制作 动画 : 它 只 是 创建 
了 动画 块 ， 并 在 其 中 设置 了 视图 的 alpha 属 性 。 


解决 方案 4-6 ”通过 修改 视图 的 alpha 属 性 来 实现 透明 度 渐变 的 动画 效果 


- (void)fadeOut: (id)sender 
| 
self.navigationItem.rightBarButtonItem.enabled - NO; 
[UIView animateWithDuration:1.0f 
animations: ~{ 
// Here's where the actual fade out takes place 
imageView.alpha = 0.0f; 
| 
completion:^(BOOL done) { 
self .navigationItem.rightBarButtonItem.enabled = YES; 
self.navigationItem.rightBarButtonItem = 
BARBUTTON (@"Fade In", Gselector(fadeIn:)); 
IF 
) 
- (void)fadeIn: (id) sender 
| 
self.navigationItem.rightBarButtonItem.enabled - NO; 
[UIView animateWithDuration:1.0f 
animations:^[ 
// Here's where the fade in occurs 
imageView.alpha - 1.0f; 
| 
completion:^(BOOL done) { 
self .navigationItem.rightBarButtonItem.enabled = YES; 
self.navigationItem.rightBarButtonItem = 
BARBUTTON (@"Fade Out", @selector(fadeOut:) ) ; 


Pl; 


请 注意 看 这 段 代 码 是 如 何 处 理 导航 栏 右边 的 UlBarButtonltem 按 钮 的 。 当 用 户 点 击 按钮 时 ， 我 们 迅速 将 该 按钮 茜 用 ， 直 到 动画 结束 之 后 ， 表 重新 局 用 它 。 我 们 给 
animateWithDuration 方 法 的 completion 参 数 传 入 了 一 个 块 ， 这 个 块 会 重新 局 用 按钮 ， 切 换 按钮 的 文本 ， 并 通过 @ selector 把 效果 相反 的 方法 设 为 按钮 的 回调 。 这 样 
的 话 ， 用 户 每 次 点 击 该 按钮 时 ，imageView 所 呈现 的 动画 效果 束 会 与 上 次 相反 ， 也 就 是 说 ,会 轮流 播放 淡 入 动画 与 淡出 动画 。 


413 ”解决 方案 : 交换 两 个 视图 的 前 后 顺序 


通过 动画 块 ， 我 们 可 以 同时 实现 许多 与 UIView 有 天 的 动画 效果 ， 而 不 仪 仪 局 限于 一 种 。 动 画 块 里 面 可 以 放 入 很 多 竺 改变 的 属性 。 解 决 方案 4- 7 把 缩放 倍数 的 变化 
与 透明 度 的 变化 结合 起 来 ， 创 建 出 了 更 为 丰富 的 动画 效果 。 它 向 动画 块 里 面 添 加 了 数 条 指令 ， 使 得 程序 同时 呈现 五 个 方面 的 动画 效果 。 它 会 放大 其 中 一 个 视图 , 令 其 
淡 入 ， 同 时 又 缩小 另外 一 个 视图 ， 令 其 淡出 ， 然 后 交换 这 两 个 视图 在 subviews 数 组 里 的 位 置 。 


解决 万 案 4-7 ”在 块 里 面 修改 多 项 视图 属性 ， 以 制作 复杂 的 动画 效果 


@implementation TestBedViewController 
-~ (void) swap: (id)sender 


| 


self.navigationItem.rightBarButtonItem.enabled = NO; 
[UIView animateWithDuration:1.0f 
animations:^( 
frontObject.alpha = 0.0f; 
backObject.alpha = 1.0f; 
frontObject.transform - CGAffineTransformMakeScale(0.25f, 0.25f); 
backObject.transform - CGAffineTransformIdentity; 
[self.view exchangeSubviewAtIndex:0 
withSubviewAtIndex:1]; 


| 


completion:^(BOOL done) { 
self .navigationItem.rightBarButtonItem.enabled = YES; 


//| Swap the view references 
UIImageView *tmp = frontObject; 
frontObject = backObject; 
backObject = tmp; 


Fi 


\ 一 /一 


首次 执行 动画 之 前 ,我 们 要 先 做 一 些 准 备 ， 也 就 是 要 将 backObject 缩 小 ， 并 令 其 透明 。 这 样 的 话 ， 当 程序 初次 运行 Swap: 方法 时 ， 这 个 backObject 视 图 残 可 以 
淡 入 到 屏幕 中 ， 并 逐渐 变 大 。 与 解决 方案 4-6 相 似 ， 我 们 也 在 传 给 completion 参 数 的 那个 块 里 面 重新 局 用 了 UIBarButtonltem 按 钮 ， 使 得 用 尸 可 以 在 动画 效果 结束 之 
后 继续 操作 该 按钮 。 


4.14 解决 万 案 : 翻转 钢 图 


UlView 类 的 transitionFromView 方 法 也 使 用 块 ， 我 们 可 以 通过 它 实 现 出 比 前 面 更 为 丰富 的 动画 效果 来 。 系 统 提供 了 许多 种 切换 风格 (transition style) ， 其 效果 
均 与 风格 的 名 称 相符 。 我 们 可 以 把 视图 翻转 到 背面 ， 也 可 以 像 Maps (地 图 ) 程序 那样 ， 将 其 向 上 或 向 下 卷 起 来 。 解 决 方案 4-8 演 示 了 如 何 把 这 些 切换 效果 融入 到 程序 


界面 中 。 
下 面 列 出 iOS 7.0 的 切换 效果 。 其 中 有 四 种 翻转 效果 、 两 种 卷 起 效果 、 一 种 交叉 融入 (cross dissolve) 效果 以 及 一 种 什么 效果 都 没有 的 空 操作 (no-op) : 
: UIViewAnimationOptionTransitionNone 
: UIViewAnimationOptionTransitionFlipFromLeft 
: UIViewAnimationOptionTransitionFlipFromRight 
: UIViewAnimationOptionTransitionFlipFromTop 
: UIViewAnimationOptionTransitionFlipFromBottom 
: UIViewAnimationOptionTransitionCurlUp 
: UIViewAnimationOptionTransitionCurtlDown 


: UIViewAnimationOptionTransitionCrossDissolve 


解决 方案 4-8 使 用 transitionFromView: toView: duration: options: completion: 这 个 基于 块 的 API。 该 方法 会 令 程序 从 一 个 视图 切换 到 另 一 个 视图 ， 并 把 前 
者 从 其 上 级 视图 里 移 除 ， 同 时 将 后 者 作为 新 视图 添加 到 那个 上 级 视图 中 。 它 会 在 给 定 的 时 长 (duration) 内 ， 依 照 用 户 所 指定 的 切换 方式 及 选项 标志 来 完成 这 段 动画 
效果 。 解 决 方案 4-8 使 用 了 从 左 往 右 的 翻转 效果 ， 不 过 读者 也 可 以 根据 自己 的 想法 来 指定 其 他 切换 方式 。 


解决 方案 4-8 通过 transitionFromView 来 实现 UIView 之 间 的 切换 动画 


- (void) flip: (id) sender 
| 
self.navigationItem.rightBarButtonItem.enabled - NO; 
UIView *toView - fromPurple ? maroon : purple; 
UIView *fromView - fromPurple ? purple : maroon; 
[UIView transitionFromView: fromView 
toView: toView 
duration: 1.0f 
options: UIViewAnimationOptionTransitionFlipFromLeft 
completion: ^(BOOL done) { 
self.navigationItem.rightBarButtonItem.enabled - YES; 
fromPurple - !fromPurple; 
CENTER VIEW(self.view, toView); 


}]; 


还 有 个 与 之 相关 但 更 为 灵活 的 方法 ， 叫 作 transitionWithView: duration: options: animations: completion: 。 它 的 animations 参 数 接受 一 个 块 ， 开 发 者 可 
以 由 此 来 全 方位 地 定制 视图 之 间 的 切换 效果 。 我 们 可 以 实现 出 缩放 、 翻 转 以 及 其 他 各 种 复杂 的 视图 切换 动画 。 


如 果 使 用 了 约束 (第 ?5 章 会 讲 到 ) ， 那 么 必须 重新 定义 它们 。 把 子 视图 从 上 级 视图 里 移 除 之 后 ， 上 级 视图 中 的 所 有 约束 都 将 无 效 。 


4.15 ”解决 方案 : 采用 Core Animation APl 来 制作 切换 效果 


除了 UIlView 动 画 之 外 ，iOS 也 支持 用 Core Animation 来 实现 动画 效果 ， 而 这 些 功 能 是 Quartz Core 框 架 的 一 部 分 。Core Animation AP|I 为 应 用 程序 提供 了 可 以 高 
度 定 制 的 动画 解决 方案 。 其 优点 在 于 : 它 不 仅 内 置 了 与 解决 方案 4-8 相 同 的 切换 功能 ， 用 以 实现 视图 之 间 的 切换 效果 ， 而 且 还 能 实现 一 大 批 位 于 本 章 讨 论 范围 之 外 的 基 
本 动画 特效 。 


Qi 在 发 行 新 版 iDS 的 过 程 中 ， 革 果 公 司 会 持续 将 Cote Animation 里 的 功能 直接 移植 到 UIKit。iOS 7 为 UIView 添 加 了 “关键 帧 动画 ”这 一 功能 ， 而 在 此 之 前 ， 


开发 者 必须 通过 Cote Animation 才 能 实现 它 。 


有 了 Core Animation 之 后 ， 我 们 在 制作 UlView 之 间 的 切换 动画 时 就 多 了 一 种 途径 ， 它 与 原来 那 种 方式 在 实现 上 面 有 几 个 小 的 区 别 。 与 CATransition 协 同 运作 的 
是 CALayer， 而 不 是 UlIView。CALayer 是 Core Animation 中 的 一 种 泻 染 表层 (rendering surface) ， 它 与 UlIView 相 关联 。 用 Core Animation 来 制作 动画 时 ， 我 们 应 
该 在 视图 默认 的 CALayer (也 就 是 myView.layer) 上 面 运 用 效果 ， 而 不 应 该 对 视图 本 身 来 运用 。 


通过 CATransition 制 作 切 换 动 画 时 ， 不 需要 像 制作 UIView 动 画 时 那样 在 块 里 面 设置 UlView 的 相关 属性 ， 而 是 要 创建 CATransition 对 象 ， 设 置 其 属性 ， 然 后 把 设置 
好 属性 值 的 这 个 对 象 添 加 到 CALayer 之 中 : 


CATransition *animation = [CATransition animation]; 
animation.delegate - self; 

animation.duration - 1.0f; 

animation.type - kCATransitionMoveIn; 
animation.subtype - kCATransitionFromTop; 


// Perform some kind of view exchange or removal here 


[myView. layer addAnimation:animation forKey:G"move in"]; 


CATransition 同 时 采用 type 及 subtype 来 定义 动画 效果 。type (2583) 表示 如 何 切换 ， 而 Subtype (FR) 则 表示 从 哪个 方向 开始 切换 。 把 两 者 合 起 来 运用 到 
CALayer 上 面 ， 也 就 相当 于 指明 了 视图 的 切换 效果 。 


Core Animation 里 面 的 切换 类 型 与 上 一 个 解决 方案 中 的 那 几 种 UIViewAnimation-Transition 选 项 是 不 同 的 。Cocoa Touch 提 供 了 四 种 类 型 的 Core Animation 切 
换 效果 ， 解 决 方案 4-9 演 示 了 它们 。 这 四 种 类 型 是 : 交叉 淡 入 淡出 (cross-fade) 、 推 动 (push， 一 个 视图 将 另 一 个 视图 推 离 屏幕 ) 、 揭 示 (reveal, 一 个 视图 从 另 一 
个 视图 上 滑 走 ， 露 出 后 者 ) 、 履 盖 (cover， 一 个 视图 滑 入 另 一 个 视图 ， 并 将 后 者 覆盖 ) 。 后 面 三 种 类 型 都 需要 通过 subtype 来 指定 动画 的 切换 方向 。 


解决 方案 4-9 用 Core Animation 实 现 切换 动画 


- (void)animate: (id) sender 
| 
// Set up the animation 
CATransition *animation = [CATransition animation]; 
animation.delegate = self; 
animation.duration = 1.0f; 


switch ([(UISegmentedControl *)self.navigationItem.titleView 
selectedSeqmentIndex]) 


case Ü; 


animation.type kCATransitionFade; 
break; 
case 1: 


animation.type - kCATransitionMoveIn; 


H 


break; 
case 2: 


animation.type - kCATransitionPush; 


break; 
case i: 


animation.type kCATransitionReveal; 


break; 
default: 
break; 


| 


animation.subtype = kCATransitionFromLeft; 


// Perform the animation 
[self.view exchangeSubviewAtIndex:0 withSubviewAtIndex:1]; 
[self.view.layer addAnimation:animation forKey:@"animation"] ; 


由 于 Core Animationz&Quartz Core 框 架 的 一 部 分 ， 所 以 在 使 用 这 些 特性 之 前 ， 需 要 先 在 代码 中 使 用 @import QuartzCore 指 令 。 


Qi. 苹果 公司 的 Cote Animation 是 通过 Objective-C 的 类 来 构建 其 二 维和 三 维 动画 特性 的 。 这 些 类 为 iDS 和 Mac 应 用 程序 提供 了 图 形 泻 染 及 动画 功能 。 使 用 Core 
Animation 的 好 处 是 ， 我 们 不 用 去 直接 操作 与 Open GL 等 技术 相关 的 许多 底层 开发 细节 ， 就 能 够 以 非常 简单 的 方式 来 操作 分 层 排 布 的 CALayet。 


4.16 解决 方案 : 使 钢 图 在 出 现 忆 后 回 弹 


苹果 公司 经 常会 连续 使 用 两 个 动画 块 ， 并 在 第 一 段 动画 结束 之 后 播放 第 二 段 ， 以 实现 回 弹 (bounce) 效果 。 比 方 说 ， 在 放大 某 个 视图 的 时 候 ， 它 会 移 把 视图 放大 
到 上 略微 超过 期 望 大 小 的 尺寸 ， 然 后 再 用 第 二 段 动 画 将 这 个 稍微 有 点 大 的 视图 缩小 到 最 终 尺 十 。 添 加 了 回 弹 效 果 之 后 ， 动 画 束 显得 更 生动 、 更 真实 了 。 


如 果 要 连续 播放 两 段 动 画 ， 那 么 需要 保证 两 段 动画 的 播放 时 段 不 会 互相 重 苹 。 最 简单 的 办 法 是 在 传 给 completion 参 数 的 那个 块 里 面 册 骨 套 一 个 动画 块 ， 把 与 第 二 
段 动画 相关 的 代码 放 在 这 个 块 里 。 解 决 方案 4-10 采 用 这 个 办 法 先 将 视图 放大 到 上 略微 超过 期 望 大 小 的 尺寸 ， 然 后 再 将 其 缩小 到 最 终 尺寸 。 


解决 方案 4-10 ”实现 视图 的 回 弹 效果 


typedef void (^AnimationBlock) (void); 
typedef void (^CompletionBlock) (BOOL finished) ; 


- (void) bounce 

{ 
// Prepare for animation 
self .navigationItem.rightBarButtonItem.enabled = NO; 
bounceView.transform = CGAffineTransformMakeScale(0.0001f, 0.0001£); 
bounceView.center = RECTCENTER ([self.view. bounds} ， 


// Define the three stages of the animation in forward order 
AnimationBlock makeSmall = "(void]| 

bounceView.transform = CGAffineTransformMakeScale(0.01£, 0.01f);}; 
AnimationBlock makeLarge = * (void) { 

bounceView.transform = CGAffineTransformMakeScale(1.15f, 1.15f];]; 
AnimationBlock restoreToOriginal = "(void) | 

bounceView.transform = CGAffineTransformIdentity;]; 


// Create the three completion links in reverse order 
CompletionBlock reenable = *(BOOL finished) | 
self.navigationItem.rightBarButtonItem.enabled = YES; |}; 
CompletionBlock shrinkBack = ^(BOOL finished) | 
[UIView animateWithDuration:0.3f 
animations:restoreToOriginal completion:reenable];]; 
CompletionBlock bounceLarge = "(BOOL finished) { 
[NSThread sleepForTimeInterval:0.5f]; // wee pause 
[UIView animateWithDuration:0.3f 
animations:makeLarge completion:shrinkBack];); 


// Start the animation 
[UIView animateWithDuration: 0.1£ 


animations:makeSmall completion:bounceLarge]; 


这 条 解决 方案 定义 了 两 个 typedef， 使 得 我 们 在 声明 传 给 animations 人 参数 及 completion 参 数 的 块 时 ， 能 够 把 代码 写 得 简单 一 些 。 请 注意 ， 笔 者 是 依照 动画 播放 顺 
序 来 定义 表示 各 个 阶段 的 那 三 个 AnimationBlock 的 。 第 一 个 块 会 将 视图 缩 到 很 小 ， 第 二 个 块 会 把 视图 放大 到 稍稍 超过 其 正常 大 小 的 尺寸 ， 而 第 三 个 块 则 会 将 视图 尺寸 


复原 。 


但 是 在 指定 CompletionBlock 时 ,顺序 则 相反 。 由 于 CompletionBlock 所 表示 的 动画 必须 在 前 一 个 动画 结束 之 后 才能 播放 ， 所 以 必须 按照 相反 的 顺序 来 创建 它 
们 。 首 先 定 义 最 后 要 执行 的 那个 块 ， 然 后 依 逆序 来 定义 其 他 块 。 在 解决 方案 4-10 之 中 ，bounceLarge 要 依赖 于 shrinkBack， 而 shrinkBack 又 要 依赖 于 reenable。 这 种 
反 向 定义 的 代码 虽然 写 起 来 有 点 麻烦 ， 但 它 肯 定 要 比 把 全 部 代码 都 逐 层 同 套 到 块 里 面 要 好 。 


本 解决 方案 的 范例 项 目 中 提供 了 一 个 名 为 AnimationHelper 的 辅助 类 ， 它 会 把 解决 方案 4-10 所 要 实现 的 功能 以 稍微 易 用 一 些 的 形式 封装 起 来 。 从 解决 方案 4-10 的 
代码 中 可 以 看 到 ， 必 须 按照 赣 序 来 定义 CompletionBlock 才 能 使 先 播放 的 那 段 动 画 能 够 引用 后 播放 的 那 段 动画 ， 而 这 种 写法 很 容易 令 代 码 变 得 杂乱 。 


辅助 类 会 构建 出 完整 的 块 序列 ， 并 返回 和 冤 有 CompletionBlock 的 块 ， 开 发 者 可 以 把 返回 的 这 个 块 经 由 animations 参 数 直 接 传 给 animateWithDuration 方 法 来 执 
行 ， 以 实现 类 似 解 决 方案 4-10 的 效果 。 


4.7 解决 万 案 : RMI 


通过 骨 套 AnimationBlock 及 CompletionBlock， 可 以 实现 出 相当 丰富 的 动画 效果 ， 不 过 ， 代 码 的 复杂 程度 也 会 迅速 升 高 。 在 iOS 7 里 ,苹果 公司 为 UIKit 引 入 了 关 
键 帧 动画 ， 这 是 一 种 强大 的 动画 功能 ， 可 以 满足 高 端 需求 。 它 能 够 极 大 地 简化 创建 动画 所 需 的 代码 ， 使 我 们 只 需 编写 少量 代码 即 可 实现 出 像 解决 方案 4-10 那 样 复 杂 的 
回 弹 效 果 。 以 前 ， 我 们 必须 深入 Core Animation 才 能 使 用 关键 帧 动画 ， 而 现在 ， 这 球 强 大 的 动画 制作 工具 已 经 直接 集成 到 UlView 里 面 了 。 


制作 传统 的 关键 帧 动画 时 ， 开 妈 者 提供 动画 序列 中 某 些 重要 的 帧 ， 并 在 动画 中 设置 相应 的 时 间 戳 ， 而 系统 则 会 把 相 邻 两 个 关键 帧 乙 间 的 其 他 帧 补 全 ， 以 便 在 各 个 
天 键 帧 乙 间 泻 染 出 平滑 的 动画 效果 。 最 简单 的 天 键 帧 动画 只 提供 起 始 帧 和 结束 帧 ， 并 把 其 他 帧 交 由 系统 来 补充 。 


在 UlIView 上 面 创建 关键 帧 动画 时 ， 我 们 要 给 animateKeyframesWithDuration: delay: options: animations: completion: 方法 的 animations 参 数 传 入 一 个 
块 。 在 这 个 块 中 ， 要 设 定 每 一 个 重要 的 参考 帧 (important reference frame， 具 体 到 本 方法 来 说 ， 丈 是 设 定 想 要 以 动画 效果 展示 其 变动 过 程 的 那些 UlView 属 性 ) , 
同时 还 要 用 addKeyframeWithRelativeStartTime: relativeDuration: animations: 来 指定 关键 帧 的 起 始 时 间 及 持续 时 长 。 系 统 会 根据 块 中 的 代码 ， 在 适当 的 时 间 点 
播放 给 定时 长 的 关键 帧 动画 序列 。 


制作 天 键 帧 动画 与 用 其 他 方式 来 制作 动画 之 间 有 个 重要 的 区 别 ， 融 是 关键 帧 动画 的 起 始 时 间 与 时 长 都 必须 在 0.0 到 1.0 这 个 范围 内 取 值 ， 这 些 值 对 应 于 整个 动画 进度 
的 百分比 。0.0 表 示 整 个 动画 流程 的 开端 ， 而 1.0 则 表示 整个 动画 流程 的 末端 。 对 于 总 长 为 两 秒 的 动画 来 说 ， 如 果菜 个 关键 帧 的 起 始 时 间 是 0.?， 那 么 它 会 出 现在 动画 播 
放 了 一 秒 钟 之 后 的 那个 位 置 上 。 


解决 方案 4-11 采 用 关键 帧 动画 实现 出 了 与 解决 方案 4-10 相 同 的 动画 效果 。 这 次 不 需要 使 用 辅助 类 ， 而 且 代 码 非 常 好 写 ， 理 解 和 管理 起 来 也 很 容易 。 


解决 方案 4-11 关键 帧 动画 


- (void) bounce 
// Prepare for animation 
self.navigationItem.rightBarButtonItem.enabled = NO; 
bounceView.transform = CGAffineTransformMakescale(0.0001f, 0.0001f)]; 
bounceView.center = RECTCENTER(self.view.bounds); 


// Begin the key frame animation 
[UIView animateKeyframesWithDuration:0.6 
delay:0.0 
options:UIViewKeyframeAnimationOptionCalculationModeCubic 
animations:"| 
// Implied first key frame - current view (tiny) 
// Second key frame - make view big 
[UIView addKeyframeWithRelativeStartTime:0.0 
relativeDuration:0.5 
animations:^l 
bounceView.transform = 
CGAffineTransformMakeScale(1.15f, 1.15£): 


H; 


// Third key frame - shrink to normal 
[UIView addKeyframeWithRelativeStartTime:0.5 
relativeDuration:0.5 
animations:^| 
bounceView.transform = 
CGAffineTransformlIdentity; 
t]; 
| 
completion: {BOOL finished) { 
[self enable:YES]; 
jl; 


418 解决 方案 : UlImageView 的 动画 效果 


UllmageView 类 不 仅 可 以 显示 静态 的 图 片 ， 而 且 也 文 持 内 置 的 动画 序列 。 把 每 一 格 动画 所 用 的 图 像 放 在 数组 里 并 加 载 到 UllmageView 之 后 ， 融 可 以 令 
UllImageView 实 例 展示 动画 效果 了 。 解 决 方案 4-12 演 示 了 具体 做 法 。 


解决 方案 4-12 ”制作 UllmageView 自 身 的 动画 效果 
NSMutableArray *butterflies = [NSMutableArray array]; 


// Load the butterfly images 
for (int i= 1; 1 <= 17; 1++) 
[butterflies addObject:[UIImage imageWithContentsOfFile: 
[[NSBundle mainBundle] 
pathForResource: [NSString stringWithFormat:G"bf £d", i] 
ofType:G"png"]]]; 


// Create the view 
UIImageView *butterflyView - [[UIImageView alloc] 
initWithFrame:CGRectMake(40.0f, 300.0f, 100.0f, 51.0£)]; 


// Set the animation cells and duration 
butterflyView.animationimages = butterflies; 
butterflyView.animationDuration - 0.75f; 
[butterflyView startAnimating]; 


// Add the view to the parent 
[self.view addSubview:butterflyView]; 


首先 ， 创 建 数组 ， 从 文件 里 把 每 张 图 片 加 载 到 数组 里 ， 并 把 该 数组 赋 给 UllmageView 实 例 的 animationlmages 属 性 。 然 后 把 展示 数组 中 全 部 图 片 所 用 的 总 时 长 设 
置 成 animationDuration 属 性 的 值 。 最 后 ， 发 送 startAnimating 消 息 以 局 动 动画 效果 。 (还 有 个 与 之 配套 的 stopAnimating 方 法 可 以 停止 动画 效果 。) 


将 本 身 正在 播放 动画 的 UllmageView 添 加 到 界面 乙 后 ， 我 们 可 以 把 它 放 在 那里 不 动 ， 也 可 以 像 对 竺 其 他 UIView 实 例 那样 ， 为 其 运用 别 的 动画 效果 。 


4.19 ”小 结 


UIView 是 一 种 用 户 可 以 看 到 并 操作 的 界面 组 件 。 通 过 阅读 本 章 ， 大 家 可 以 友 现 ， 即 便 是 最 简单 的 UIView， 也 都 具备 了 相当 灵活 而 强大 的 功能 。 我 们 学 会 了 如 何 用 
UIView 来 构建 屏幕 上 的 元 件 ， 如 何 根据 标签 或 nametag (控件 名 称 ) 来 获取 UIView， 以 及 如 何 制作 醒目 的 动画 效果 。 在 继续 学 习 下 一 章 之 前 ， 读 者 可 以 先 回顾 下 面 


几 个 问题 : 
. 处 理 多 个 视图 的 时 候 ， 一 定 要 有 层级 这 个 概念 。 通 过 与 视图 层级 相关 的 各 种 方式 来 管理 程序 中 的 视图 ， 并 根据 适当 的 情境 向 用 户 展示 出 对 应 的 视图 布局 。 


: UIKit 是 以 centet 属 性 为 中 心 的 ， 而 Core Graphics 则 不 是 。 作 为 开发 者 ， 我 们 不 应 该 令 自己 的 代码 受制 于 此 ， 而 是 应 该 通过 一 些 函 数 在 这 两 套 结 构 之 间 转 换 ， 尤 其 
是 在 应 对 一 些 没 有 施加 变换 效果 的 简单 视图 时 ， 更 应 如 此 。 


.多 使 用 标签 ， 无 论 是 数值 形式 的 标签 ， 还 是 自 定义 的 nametag 都 行 。 有 了 标签 之 后 ， 就 可 以 用 一 种 类 似 于 符号 表 (symbol table) 的 办 法 ， 在 程序 代码 中 直接 访问 
相关 的 UIView 了 。 这 些 标签 没有 什么 不 好 的 地 方 ， 在 开发 工作 中 ， 它 们 是 一 种 有 用 的 编程 技巧 。 


灵活 掌控 坐标 变换 (transform) 。 它 们 就 是 一 些 数学 运算 。 实 施 了 坐标 变换 之 后 ， 我 们 应 该 依然 有 办 法 获取 视图 的 各 项 信息 才 对 ， 比 方 说 ， 应 该 能 够 查 到 当前 的 
旋转 角度 、 缩 放 倍数 以 及 视图 四 个 角 的 位 置 等 。 在 许多 iOS 开 发 领域 ， 坐 标 变换 都 能 起 到 很 大 的 作用 。 本 章 所 提供 的 几 条 解决 方案 在 该 功能 的 基础 之 上 添加 了 一 些 特 
性 ， 使 开发 者 能 够 掌控 坐标 变换 功能 ， 以 便 在 需要 用 到 某 些 信息 时 可 以 立刻 查 到 它们 。 


` 块 太 有 用 了 。 它 们 可 以 简化 开发 工作 、 简 化 代码 的 编写 过 程 以 及 动画 的 制作 过 程 。 


. 尽 可 能 多 用 一 些 动画 效果 。 动 画 效 果 并 不 一 定 都 是 杂乱 而 拙劣 的 。iOS SDK 支 持 非 常 强大 的 动画 效果 ， 令 开发 者 能 够 在 用 户 执行 了 某 项 操作 之 后 ， 以 平滑 的 动画 
表示 出 视图 的 切换 过 程 。iOS 应 用 程序 以 精巧 而 流畅 的 切换 动画 著称 。 


` 本 章 绝 大 部 分 内 容 都 是 直接 来 调整 视图 的 层级 结构 和 摆 放 位 置 的 ， 这 样 做 的 前 提 是 开发 者 自己 控制 视图 的 布局 。 第 5 章 将 要 讲述 Auto Layout， 这 是 一 套 声明 式 的 
约束 系统 ， 用 它 来 管理 视图 的 布局 要 比 手工 管理 更 方便 、 更 强大 。 


Som ”视图 的 约束 系统 


Auto Layout (自动 布局 ) 彻底 改变 了 开 友 者 创建 用 户 界 面 (Ul) 的 方式 。 它 提供 了 一 套 强 大 而 灵活 的 系统 ， 用 于 描述 视图 与 其 内 容 之 间 的 关系 以 及 它们 同上 级 视 
图 之 间 的 关系 。 与 手动 管理 框架 的 几何 属性 及 Struts and Strutsl1] 相 比 ， 这 种 新 技术 使 开发 者 可 以 更 好 地 控制 视图 布局 ， 并 对 其 进行 全 方位 定制 。 苹 果 公 司 发 布 了 一 
些 新 设备 ， 其 屏幕 大 小 与 原来 的 设备 不 同 ， 而 且 又 引入 了 一 批 新 的 API， 使 得 Ul 和 在 程序 运行 的 时 候 可 以 动态 地 变化 ， 它 以 这 些 方 式 来 促使 开 友 者 采用 这 套 新 技术 管理 视 
图 布局 。 在 Auto Layout 问 世 之 前 ， 要 想 以 手工 方式 处 理 刚 说 的 这 些 情况 是 十 分 困难 的 ， 有 时 甚至 根本 无 法 做 到 。 


有 了 Auto Layout 之 后 ， 视 图 的 排 布 融 直 观 多 了 ， 我 们 只 需 摘 述 视图 之 间 的 天 系 即 可 ，iO3 会 负责 把 它们 摆 放 到 适当 的 位 置 上 。 此 外 ， 如 果 定 义 了 视图 之 间 的 关系 
以 及 与 动态 布局 有 关 的 属性 ， 而 不 是 以 硬 代码 来 编写 原点 及 尺寸 的 话 ， 那 么 视图 对 象 束 会 根据 屏幕 方向 、 设 备 屏 幕 的 宽 高 比 等 因素 自动 做 出 正确 的 反应 ， 运 用 了 
Dynamic Type 技 术 之 后 ， 甚 至 还 能 根据 不 同 的 界面 语言 以 及 用 户 所 设 定 的 文本 大 小 来 自动 调整 标签 (label) HRY. 


本 章 介绍 如 何 用 代码 来 控制 Auto Layout 约 束 。 约 束 定义 了 视图 之 间 的 关系 以 及 视图 同 其 视窗 、 同 上 级 视图 的 关系。iOS 系 统 会 根据 约束 来 定义 每 个 视图 实际 的 框 
"RE. 


Qi. Auto Layout 有 是 个 深奥 而 广泛 的 话题 ， 用 一 整 本 书 来 写 它 都 不 为 过 。 我 们 在 这 里 只 能 扼要 地 谈 一 谈 。 如 果 想 通过 范例 全 面 了 解 并 深入 分 析 Auto Layout 技 


术 ， 包 括 如 何在 Intetface Builder (简称 IB) 里 使 用 Auto Layout, AR A Æ X] Erica Sadun 所 闭 的 最 新 版 《iOS Auto Layout Demystified» , 该 书 也 由 Addison-Wesley 出 版 。 


[1] IJ 卫 界面 中 的 一 套 布 局 机 制 ， 可 用 来 指定 视图 的 自动 缩放 能 力 。 


译 者 注 


5.1 什么 是 约束 


约束 (constraint) 就 是 一 系列 摘 述 iOS 程 序 视图 布局 的 规则 。 它 们 限定 了 视图 之 间 的 关系 ， 也 限定 了 视图 的 布局 形式 。 使 用 约束 时 ， 我 们 可 以 说 “这 些 视图 在 水 
平方 向 上 必须 对 齐 ”， 或 是 “此 视图 必须 根据 另 一 个 视图 来 调整 自身 高 度 ， 以 便 与 乙 相符 ”。 约 束 向 开 友 者 提供 了 一 套 布 局 语言 ， 使 得 可 以 向 视图 里 添加 约束 ， 并 以 
此 来 描述 各 视图 的 空间 关系 。 


iOS 负 责 通 过 一 套 约束 满足 系统 来 实现 这 些 布局 需求 。 规 则 必须 有 意义 。 不 能 说 某 视 图 既 位 于 另 一 个 视图 左 侧 ， 又 位 于 它 的 右 侧 。 使 用 约束 时 的 一 个 难点 就 是 如 何 
保证 规则 之 间 辟 是 协调 一 致 的 。 假 如 规则 之 间 有 冲突 ， 那 么 开 上 友 者 将 收 到 明确 通知 。Xcode 会 提供 详尽 的 记录 信息 来 解释 具体 的 错误 情况 。 


另外 一 个 难点 在 于 规则 要 指定 得 足够 具体 才 行 。 如 果 对 界面 所 施加 的 约束 过 少 ， 那 么 可 能 会 产生 不 符合 预期 的 布局 ， 因 为 有 很 多 种 布局 方案 可 供 选 用 。 我 们 可 能 
会 要 求 某 视 图 处 在 男 一 个 视图 右 侧 ， 但 是 假如 不 指定 恰 直 方向 上 的 规则 ， 那 么 系统 就 可 能 会 把 右 侧 这 个 视图 排 布 在 屏幕 硕 端 ， 而 把 左 侧 那 个 视图 排 布 在 屏幕 底 端 。 


有 了 约束 ， 就 可 以 制作 出 不 依赖 于 分 辩 率 的 应 用 程序 了 。 对 于 一 款 针 对 4 英 时 屏幕 的 Phone 而 制作 的 应 用 程序 ， 只 要 是 基于 约束 的 ， 那 么 不 用 修改 任何 代码 ， 就 可 
以 直接 运行 在 将 来 友 售 的 5 英 叶 iPhone 上 。 


对 于 需要 进行 本 地 化 的 程序 来 说 ， 不 要 为 每 种 界面 语言 都 创建 一 个 XIB， 而 是 应 该 采用 约束 。 基 于 约束 的 XIB 可 以 适应 多 种 界面 语言 。 


开发 者 既 可 以 在 1B 中 以 可 视 化 的 形式 来 指定 约束 ， 也 可 以 在 程序 源码 中 以 编程 的 形式 来 制作 约束 。Xcode 5 的 1B 对 Auto Layout 功 能 做 了 很 多 改进 。 用 IB 来 调整 约 
束 及 视图 布局 简单 易 行 ， 本 章 则 专门 讲解 如 何 用 代码 来 操作 约束 。 我 们 提供 以 代码 为 中 心 的 范例 ， 通 过 这 些 范例 ， 读 者 可 以 用 Objective-C 语 言 为 视图 创建 出 常见 的 约 
Re 


5.2 ”约束 系统 所 用 的 属性 


约束 所 用 的 词汇 非 党 有限 ， 融 是 一 些 与 几何 特征 有 天 的 属性 及 关系 。 属 性 是 约束 系统 中 的 “名 词 ”， 用 来 摘 述 视图 对 齐 忠 形 (alignment rectangle) 里 的 位 置 。 
稍 后 我 们 会 详细 解释 对 齐 窍 形 这 一 概念 ， 而 现在 大 家 可 以 把 它 看 作 与 视图 的 框 淋 紧密 相 天 的 一 个 东西 。 天 系 (relation) 是 系统 里 的 “动词 ”， 用 于 在 属性 之 间 进 行 比 


较 。 


属性 名 词 摘 述 的 是 物理 特征 。 约 束 系统 提供 了 下 面 这 几 个 “名 词 ”， 用 来 摘 述 视图 的 相 天 属性 : 


: left, right, top%bottom 视图 对 齐 适 形 的 左 、 右 、 上 、 下 边界 。 它 们 分 别 对 应 于 视图 的 最 小 X 值 、 最 大 X 值 、 最 小 Y 值 以 及 最 大 Y 值 。 


视图 对 齐 适 形 的 前 边沿 及 后 边 活 。 在 从 左 至 右 的 书写 系统 里 (比如 英文 ) ， 前 边沿 就 是 “ 左 ”， 后 边沿 就 是 “ 右 ”。 而 在 阿拉 伯 文 、 希 伯 


: leadingXtrailing 


来 文 等 从 右 至 左 的 语言 环境 下 ， 则 相反 : 前 边沿 是 “ 右 ”， 后 边沿 是 “ 左 ” 


如 果 要 令 应 用 程序 支持 多 种 界面 语言 ， 那 么 应 该 使 用 leading 和 trailing 来 代替 left 和 right。 这 样 的 话 ， 在 阿拉 伯 文 和 希 伯 来 文 等 语言 环境 下 ， 应 用 程序 的 界面 就 能 


在 左右 方向 上 自动 反 转 了 。 


: width 与 height 一 一 视图 对 齐 珑 形 的 宽度 和 高 度 。 


- centerX 5 centerY 


ILA FET 89 P Ex dh Foy Hh hg AAR o 
- baseline 一 一 对 齐 死 形 的 基线 ， 通 常 比 bottom 属 性 小 一 些 ， 而 且 两 者 之 间 的 偏 移 量 通常 是 某 个 定 值 。 


关系 动词 用 于 比较 属性 值 之 间 的 关系 。 在 约束 系统 的 数学 运算 中 只 有 三 种 关系 : 我 们 可 以 限定 两 个 属性 必须 相等 ， 也 可 以 限定 其 下 界 或 上 界 。 可 以 使 用 下 面 三 种 
布局 关系 : 


- Less-than inequality (小 于 或 等 于 ) 一 一 NSLayoutRelationLessThanOrEqual 
Equality (等 于 ) 一 一 NSLayoutRelationEqual 
: Greater-than inequality (大 于 或 等 于 ) ——NSLayoutRelationGreater ThanO r-Equal 


你 可 能 党 得 上 面 这 三 种 关系 不 会 产生 太 多 的 布局 组 合 。 但 实际 上 ， 这 三 种 关系 可 以 把 排 布 用 户 界 面 时 所 需 的 各 种 布局 情况 全 都 涵盖 进来 。 通 过 这 三 种 关系 我们 
可 以 给 属性 指定 具体 的 值 ， 也 可 以 指定 其 上 限 或 下 限 。 


约束 系统 所 用 的 数学 算式 


对 于 所 有 的 约束 规则 ， 无 论 它 是 如 何 创建 出 来 的 ， 其 本 质 都 可 归结 为 下 列 形式 的 等 式 或 不 等 式 : 


y X Am*xtb 
如 果 读 者 掌握 了 一 些 数学 知识 ， 那 么 可 能 会 熟悉 男 一 个 与 上 述 算式 很 相似 的 表述 形式 ， 式 子 中 的 R 就 表示 y 与 右 侧 运 算 值 之 间 的 关系 : 
y R m*x+b 


y 与 x 都 是 上 面 介 绍 过 的 那些 视图 属性 ， 比 方 说 width、centerY 或 top。 而 m 则 是 个 表示 缩放 比例 的 常数 ，b 是 表示 偏 移 量 的 常数 。 例 如 ,我们 可 以 规定 ，“B 视 图 
的 左 界 应 该 位 于 A 视图 右 界 的 右 方 15 点 处 ”。 那 么 关系 式 就 可 以 写成 : 


B 视 图 的 左 界 =A 视 图 的 右 界 +15 


XED "FT" KR, WEERA (b) 是 1?， 缩 放 倍数 或 放大 倍数 (multiplier, m) 是 1。 笔 者 故意 没有 把 上 面 这 个 式 子 写 得 和 代码 一 样 ， 因 为 我 们 并 不 需要 以 
Objective-C 代 码 的 形式 来 直接 声明 约束 规则 。 


约束 规则 未 必 都 是 严格 的 等 式 ， 也 可 以 使 用 “不 等 ”关系 。 比 方 说 ， 我 们 可 以 规定 ，“B 视 图 的 左 界 应 该 距离 A 视 图 右 界 的 右 方 至 少 15 点 ”。 这 可 以 写成 : 
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我 们 可 以 通过 偏 移 量 (b) GRACIAS, FHWA (m) 来 进行 缩放 ， 这 对 于 网 格 形 式 的 布局 来 说 尤为 有 用 ， 因 为 开发 者 可 以 直接 把 某 个 视 
图 的 高 度 设 为 男 一 个 视图 的 若干 倍 ， 而 不 用 在 两 个 视图 之 间 添 加 固定 的 间隔 距离 。 


5.3 约束 系统 的 运作 规律 


你 可 能 认为 约束 系统 所 用 的 数学 算式 非常 严格 ， 实 际 上 它们 只 是 个 参考 。iOS 会 找到 最 符合 约束 的 一 种 布局 方案 ， 有 的 时 人 息 ， 这 种 方案 不 止 一 套 。 下 面 给 出 约束 系 
统 的 一 些 基 本 特征 : 


` 约束 规则 描述 的 是 关系 ， 而 不 一 定 是 视图 在 某 个 方向 上 的 属性 。 未 必 非 要 在 知道 右边 界 的 情况 下 才能 算出 左边 界 。 


- 每 条 约束 规则 都 有 其 优先 级 。 优 先 级 的 取 值 范围 是 从 0 到 1000。Auto Layout 系 统 用 优先 级 来 排列 各 条 约束 的 顺序 。 它 总 是 先 设 法 满足 优先 级 较 高 的 约束 规则 ， 然 
后 再 去 满足 优先 级 较 低 的 规则 。 优 先 级 为 99 的 规则 总 是 排 在 优先 级 为 100 的 规则 后 面 。 在 排 布 视图 位 置 的 时 候 ， 系 统 会 遍历 开发 者 所 添加 的 全 部 规则 ， 并 试 着 找 出 一 种 
符合 所 有 约束 规则 的 布局 方案 。 优 先 级 用 来 判定 各 条 规则 的 影响 力 。 假 如 刚才 说 的 那 两 条 约束 规则 互相 冲突 ， 那 么 系统 会 考虑 优先 级 为 100 的 那 条 规则 ， 而 放弃 优先 级 
为 99 的 那 条 。 


优先 级 最 高 的 约束 规则 是 必须 要 满足 的 (required) ， 它 的 类 型 是 UlLayoutPriority-Required， 其 值 为 1000， 而 这 种 类 型 也 是 系统 默认 的 约束 类 型 。 优 先 级 为 
1000 的 约束 必须 完全 满足 才 行 ， 比 方 说 ,我 们 可 以 表达 出 “此 按钮 必须 是 这 种 尺寸 ”等 意图 。 假 如 某 条 约束 规则 的 优先 级 不 是 1000， 那 么 它 在 整个 布局 系统 里 的 影响 
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但 即便 是 必须 满足 的 约束 ， 也 有 可 能 在 友 生 冲突 的 情况 下 遭 到 覆 善 。 如 果 我 们 没有 权衡 好 各 条 规则 之 间 的 关系 ， 那 么 很 有 可 能 令 本 来 应 该 是 100x100 的 视图 变 成 


102x107。 表 5-1 详 细 列 出 了 几 种 约束 规则 的 优先 级 和 对 应 的 值 。 


表 5-1 表示 优先 级 的 各 种 常量 


种 类 值 


UILayoutPriorityRequired (默认 ) 1 000 
UILayoutPriorityDefaultHigh 750 
UILayoutPriorityDefaultLow 250 
UILayoutPriorityFittingSizeLevel 50 


- 除了 优先 级 这 一 因素 之 外 ， 各 条 约束 规则 之 间 并 没有 其 他 自然 的 顺序 。 系 统 会 同时 考虑 优先 级 相同 的 一 系列 约束 。 如 果 想 令 某 条 约束 占 先 ， 那 么 可 以 提升 其 优 
先 级 。 


. 有 些 约束 规则 只 需 大 致 满足 即 可 。 我 们 可 以 用 一 些 可 选 的 (optional) 约束 规则 来 试 着 优化 一 下 布局 效果 。 比 方 说 ，“2 号 视图 的 顶 边 应 该 和 1 号 视图 的 底 边 处 在 
同一 位 置 ”。 约 束 系 统 会 试 着 令 两 个 视图 靠近 ， 并 尽量 缩小 其 距离 。 假 如 有 其 他 约束 规则 使 得 这 两 个 视图 无 法 紧 贴 ， 那 么 系统 会 尽 可 能 地 令 它 们 人 靠拢， 以 缩小 这 两 个 


属性 之 间 的 差距 。 


- 约束 规则 之 间 可 以 有 循环 。 所 涉及 的 控件 只 要 都 满足 规则 就 行 了 ， 并 不 需要 明确 每 个 视图 具体 对 应 于 规则 中 的 哪个 物件 。 不 要 跟 交 叉 引 用 较劲 。 这 套 声 明 式 的 
系统 可 以 接受 循环 引用 ， 所 以 开发 者 无 须 担 心 无 限 循环 问题 。 


- 可 以 用 动画 来 表现 约束 规则 的 变化 过 程 。 从 一 套 约 束 规则 切换 到 另 一 套 的 时 候 ， 可 以 用 UIView 的 动画 功能 来 表现 这 个 过 程 。 在 动画 块 中 ， 我 们 可 以 于 改变 约束 
规则 之 后 调用 layoutIfNeeded， 这 样 的 话 ， 视 图 就 会 以 动画 效果 来 展示 由 上 一 套 约束 规则 切换 到 新 规则 的 过 程 。 


- 在 约束 规则 里 可 以 引用 同一 体系 里 的 其 他 视图 。 对 于 某 个 视图 来 说 ， 可 以 令 其 中 一 个 子 视图 的 中 心 点 与 另外 一 个 完全 不 同 的 视图 的 中 心 点 相对 齐 ， 只 要 两 者 之 
间 有 公共 的 祖先 视图 即 可 。 比 方 说 ， 我 们 创建 了 一 种 复杂 的 文本 输入 视图 ， 其 中 还 蓄 套 有 UIImageView 控 件 ， 那 么 现在 可 以 令 它 最 右 侧 那个 按钮 的 fight 属 性 与 按钮 下 方 
UIImageView 控 件 的 tight 属 性 相对 齐 。 但 是 下 一 段 将 会 讲述 一 种 例外 情况 。 


约束 规则 不 应 该 跨越 边界 系统 (bound system) 。 在 指定 对 齐 方式 的 时 候 ， 不 要 跨越 UIScrollView、UICollectionView 及 UITableView 的 边界 。 如 果菜 种 视图 有 它 
自己 的 边界 系统 ， 那 么 就 不 要 从 一 个 边界 系统 跳 到 另 一 个 完全 不 同 的 边界 系统 里 面 去 。 虽 说 这 么 做 可 能 不 会 使 程序 前 溃 ， 但 毕竟 不 是 个 好 办 法 ， 而 且 Auto Layout 对 这 
种 做 法 的 支持 度 也 不 好 。 


- Auto LayoutStra nsform (坐标 变换 ) 之 间 可 能 配合 得 不 够 好 。 同 时 使 用 transform 及 Auto Layout 时 要 多 加 小 心 ， 尤 其 在 涉及 旋转 的 情况 下 更 是 如 此 。 


- Auto Layout 不 能 和 iOS7 所 提供 的 U IKit Dynamics 协 同 运作 。 受 动态 行为 所 影响 的 那些 视图 依然 可 以 施加 Auto Layout， 但 如 果 某 个 视图 处 在 UIDynamicAnimator 
的 管理 之 下 ， 那 么 就 不 能 同时 用 Auto Layout 去 调整 它 的 排 布 方式 了 。 


- Auto Layout 可 以 和 iOS 7 的 运动 效果 (motion effect) 一 起 工作 。 由 UIMotion-Effect 实 例 所 产生 的 视觉 变化 只 会 影响 视图 的 CALayer， 而 不 会 干扰 底层 的 布 
局 。 


- 约束 规则 在 运行 期 可 能 会 出 错 。 如 果 系 统 无 法 解析 开发 者 所 设 定 的 约束 规则 (参看 本 章 末 尾 的 范例 ) ， 或 是 规则 之 间 有 冲突 ， 那 么 运行 期 系统 就 会 丢弃 一 些 规 
则 ， 以 便 尽 量 把 视图 排 布 出 来 。 这 种 做 法 很 不 优雅 ， 而 且 经 常会 产生 与 程序 需求 不 符 的 布局 。Auto Layout 会 把 详尽 的 信息 发 送 到 Xcode 控制 台 ， 告 诉 开 发 者 哪里 出 了 
错 。 我 们 可 以 根据 这 些 错误 报告 来 修正 约束 规则 ， 使 各 条 规则 之 间 和 谐 一 致 。 


”格式 错误 的 约束 规则 可 能 会 阻 断 应 用 程序 的 执行 。 规 则 之 间 若 有 了 冲突 ， 则 只 会 产生 错误 消息 ， 而 应 用 程序 还 是 可 以 继续 运行 的 ， 但 是 ， 如 果 规 则 的 格式 写 错 
了 ， 那 么 执行 了 某 些 调用 之 后 ， 程 序 就 会 因为 未 处 理 的 异常 而 盘 溃 。 比 方 说 ， 我 们 可 能 会 把 类 似 于 @'"VFview1]-| "的 格式 字符 串 传 给 相关 方法 ， 以 根据 字符 串 所 描述 的 
规则 来 创建 约束 ， 但 此 时 就 会 遭遇 运行 期 错误 (因为 字母 V 的 后 面 漏 了 个 冒号 ) : 


Terminating app due to uncaught exception 'NSInvalidArgumentException', reason: 
'Unable to parse constraint format' 


这 种 错误 在 编译 的 时 候 无 法 检测 到 ， 所 以 我 们 必须 仔细 检查 格式 字符 串 。 在 |B 里 面 设计 约束 规则 时 ， 就 不 用 担心 由 于 拼写 错误 而 导致 的 程序 崩溃 问题 了 。 


每 条 约束 规则 必须 至 少 引 用 一 个 视图 。 如 果 创 建 了 一 条 没有 引用 任何 视图 的 约束 规则 ， 那 么 Xcode 在 编译 代码 时 不 会 产生 警告 ， 但 程序 却 会 在 运行 的 时 候 抛 出 异 


Ri 


. 避免 无 效 的 属性 搭配 。 把 某 个 视图 的 左边 界 和 另 一 个 视图 的 高 度 相 匹配 是 不 合法 的 。 无 效 的 属性 组 合 会 令 程序 在 运行 的 时 候 抛 出 异常 。 尤 其 不 应 该 把 与 尺寸 有 
关 的 属性 和 与 边界 有 关 的 属性 混 起 来 用 。 一 般 来 说 ， 我 们 都 能 够 把 有 问题 的 属性 组 合 检查 出 来 ， 因 为 那些 属性 搭配 在 一 起 是 没有 意义 的 。 
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测试 来 尽量 确保 相关 操作 在 各 种 情况 下 都 正常 运作 。 但 愿 有 人 能 够 写 出 一 款 约 束 规则 验证 器 (constraint validator) ， 它 至 少 要 能 够 把 @"'H: [myView" 等 简单 的 拼写 错误 


找 出 来 ， 并 告诉 我 们 这 条 规则 少 了 右 方 括号 。 


5.4 ”约束 规则 与 框 染 属 性 


Auto Layout 约 束 系统 所 使 用 的 底层 几何 特征 与 第 4 章 中 frame 所 使 用 的 特征 是 相同 的 。Auto Layout 的 强大 之 处 基本 上 在 于 : 它 排 布 UI 的 同时 ， 还 可 以 处 理 内 容 
多 变 的 视图 。UIView 有 两 个 属性 ， 分 别 是 固有 内 容 的 尺寸 (intrinsicContentsize) 以 及 对 齐 矩 形 (alignmentRectForFrame: ) ， 该 和 矩形 的 范围 可 以 超越 传统 的 框 
架 ， 以 便 使 Auto Layout 系 统 能 够 适当 地 处 理 视图 之 间 的 关系 。 


5.4.1 固有 内 容 的 尺寸 


在 Auto Layout 系 统 中 ， 视 图 的 内 容 与 视图 的 约束 规则 一 样 ， 都 对 布局 起 着 重要 作用 。 内 容 是 通过 每 个 视图 的 intrinsicContentSize 属 性 表达 出 来 的 。 该 方法 描述 
了 在 既 不 挤 压 也 不 裁 切 的 前 提 下 完全 容纳 视图 内 容 所 需 的 最 小 空间 ， 其 含义 可 以 根据 每 个 视图 所 要 表示 的 内 容 而 推断 出 来 。 


例如 ， 对 于 UllmageView 来 说 ， 这 就 相当 于 其 中 的 图 像 所 具备 的 尺寸 。 图 像 如 果 比 较 大 ， 那 么 intrinsicContentSize 也 就 会 大 一 些 。 而 对 于 标签 控件 来 说 ， 则 取决 
于 字体 和 文本 量 (text amount) 。 标 签 控 件 的 intrinsicContentSize 会 随 着 文本 长 短 与 所 选 字 体 而 变化 。 


有 了 intrinsicContentSize 之 后 ，Auto Layout 系 统 就 可 以 把 视图 的 框架 属性 与 其 内 容 较 好 地 匹配 起 来 。 我 们 通常 需要 在 每 个 轴 上 设置 两 种 属性 才能 避免 约束 规则 
过 少 或 排版 方式 有 歧义 等 情况 。 为 视图 指定 了 intrinsicContentSize 之 后 ， 就 相当 于 已 经 有 了 其 中 一 种 属性 。 现 在 我 们 可 以 把 某 个 基于 文本 的 控件 或 UllImageView 控 件 
放 在 上 级 视图 的 中 心 ， 这 样 的 排版 方案 只 有 一 种 ， 所 以 不 会 产生 歧义 。 把 intrinsicContentSize 与 location (位 置 ) 结合 起 来 ， 就 可 以 完整 地 确定 视图 的 排 布 方式 了 。 
实际 上 ，Auto Layout 系 统 在 排版 时 会 把 intrinsicContentSize 解 析 成 一 条 约束 规则 。 


变 视图 的 内 容 之 后 ， 我 们 可 以 调用 invalidatelntrinsicContentSize 方 法 ， 以 此 告知 Auto Layout 系 统 下 次 排版 时 应 该 重新 计算 intrinsicContentSize。 
Compression Resistance 与 Content Hugging 


Auto Layout 系 统 在 判定 intrinsicContent9Size 的 大 小 时 会 受到 两 个 属性 的 影响 。 正 如 其 名 称 所 示 ，Compression Resistance ( 抗 挤 压 性 ) 表示 视图 保护 其 内 容 不 
受 压缩 的 能 力 。 抗 挤 压 性 越 高 的 视图 ， 越 不 容易 收缩 。 它 要 竭力 避免 内 容 遭 到 裁 切 (cip) 。 而 content hugging (内 容 凝 聚 度 ) 则 表示 一 种 优先 级 ， 它 指明 视图 是 否 
不 愿意 在 其 核心 内 容 之 外 添加 边 距 ， 或 视图 是 否 不 愿意 拉 伸 其 核心 内 容 (比方 说 ，contentM ode 属 性 设 为 “缩放 ” [的 UllmageView 控 件 是 否 不 愿意 拉 伸 其 图 像 ) 。 
开发 者 可 以 通过 setContentCompressionResistancepPriority: forAxis: 及 setContentHugging-Priority: forAxis: 方法 按 坐 标 轴 来 设置 视图 的 这 两 种 优先 级 。 


[1] 指 代 UIViewContentModeScaleToFill、UIViewContentModeScaleAspectFit 及 UIViewContent-ModeScaleAspectFill 这 三 种 内 容 显 示 模 式 。 译 者 注 


5.4.2. XJZTXEJEZ 
约束 系统 所 采用 的 布局 办 法 与 手动 排版 时 所 用 的 框架 不 同 。 框 架 摘 述 的 是 视图 摆 放 的 位 置 以 及 视图 的 大 小 ， 而 约束 系统 在 排 布 视图 时 ， 则 使 用 一 个 与 乙 相关 的 几 
何 概念 ， 即 对 齐 矩 形 (alignment rectangle) 。 


在 创建 复杂 的 视图 了 时， 开发 者 可 能 会 引入 一 些 视觉 上 的 装饰 效果 ， 例 如 阴影 、 边 缘 高 亮 (exterior highlight) 、 镜 像 (reflection) 以 及 有 雕刻 线条 (engraving 
line) 等 。 这 些 特性 通常 是 以 子 视图 或 子 层 的 形式 添加 到 视图 里 的 。 在 添加 这 些 物 件 的 过 程 中 ， 视 图 的 框架 及 其 完整 范围 也 会 随 之 不 断 变 大 。 


三 frame 不同， 视图 的 对 齐 和 矩形 仅 局 限于 核心 视觉 元 件 (core visual element) 。 把 新 的 物件 添加 到 主 视图 并 不 会 影响 它 的 大 小 。 请 看 图 5-1 左 侧 的 示意 图 。 这 个 
示意 图 市 有 阴影 效果 和 徽章 图 样 ， 阴 影 效果 位 于 主 视图 的 后 方 ， 而 微 章 则 在 视图 右上 角 。 排 布 这 个 视图 的 时 候 ，Auto Layout 只 会 把 核心 元 件 同 其 他 视图 相对 齐 。 
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图 5-1 视图 的 对 齐 和 珑 形 (中 间 示 意图 里 的 黑色 框 线 ) 只 涵盖 待 对 齐 的 核心 视觉 元 件 ， 而 不 考虑 附加 的 修饰 效果 


图 2-1 中 间 那 张 示意 图 摘 绘 了 视图 的 对 齐 忠 形 。 该 息 形 把 阴影 及 徽章 等 委 饰 物 都 排除 在 外 。 我 们 只 希望 Auto Layout 系 统 参照 对 齐 忠 形 里 面 的 这 部 分 内 容 来 排 布 视 


(ix STB S- 1 AiR SAA MEAP. a MEIC ARMA SEAS, Te, CEH Auto Layout 系 统 在 对 齐 这 个 视图 时 所 应 
参考 的 边界 。 那 个 矩形 把 视图 的 所 有 视觉 元 件 都 涵 兰 进来 了 。 假 如 按照 此 起 形 来 排版 ， 那 么 这 些 妆 饰物 可 能 会 干扰 排列 视图 位 置 时 所 参照 的 一 些 特征 〈 例 如 中 心 点 、 
XO. AAS) 。 


Auto Layout 系 统 是 根据 对 齐 和 矩形 来 排 布 视图 位 置 的 ， 而 不 是 根据 框架 属性 ， 这 样 可 以 确保 排版 时 所 参照 的 关键 信息 (例如 视图 的 边界 及 中 心 点 等 ) 准确 无 误 。 
声明 对 齐 窍 形 


在 构建 市 有 六 饰物 的 视图 时 (例如 内 置 有 阴影 效果 的 UllmageView) ， 开 发 者 应 该 把 详细 的 几何 特征 告诉 Auto Layout 系 统 。 如 果 目 己 的 视图 使 用 了 阴影 或 镜像 
效果 等 装饰 物 ， 那 么 可 以 在 视图 类 里 实现 alignmentRectForFrame: 方法 ， 并 返回 精确 的 对 齐 答 形 。 


该 方法 接受 一 个 参数 ， 也 就 是 框架 。 该 参数 表示 视图 所 居 的 目标 框架 (destination frame) 。 请 看 图 5-1 右 侧 示 意图 中 的 矩形 。 那 个 矩形 所 代表 的 框架 就 涵盖 了 
整个 视图 ， 这 其 中 也 包括 附着 在 视图 上 的 涂饰 物 。 开 发 者 应 该 根据 那个 目标 框架 以 及 视图 中 所 谨 入 的 元 件 来 计算 出 精确 的 对 齐 算 形 。 


此 方法 所 返回 的 CGRect 值 指明 了 视图 的 核心 视觉 内 容 所 处 的 那个 矩形 ， 如 图 5-1 中 间 的 矩形 所 示 。 它 通常 就 是 主 视图 对 象 本 身 的 框架 ， 而 不 包括 作为 子 视图 或 
CALayer 的 子 层 添加 到 视图 中 的 那些 装饰 物 。 


如 果 要 对 视图 执行 坐标 变换 ， 那 么 请 记得 一 并 实现 frameForAlignmentRect: 方法 。 该 方法 摘 述 的 是 反 向 关系 ， 也 融 是 根据 传 入 的 对 齐 答 形 (比方 说 ， 图 5-1 中 
间 那 张 示 意图 里 的 矩形 ) 来 算出 可 以 完整 包含 所 有 装饰 物 的 框架 (比方 说 ， 图 5-1 右 侧 示 意图 里 的 那个 矩形) 。 我 们 会 以 传 入 的 那个 对 齐 算 形 为 基础 扩大 其 边界 ， 使 乙 
能 够 把 视图 里 的 所 有 妆 饰 物 都 涵盖 进来 。 


5.5 ”创建 约束 规则 


通过 NSLayoutConstraint 类 ， 开 上 者 可 以 用 两 种 方式 来 创建 约束 规则 。 可 以 用 一 个 相当 长 的 方法 调用 语句 来 指明 视图 的 某 个 属性 与 其 他 属性 乙 间 的 天 系 ， 并 摘 述 
这 些 属性 之 间 的 联系 ， 也 可 以 用 一 种 写 起 来 非常 短小 的 格式 化 语言 (formatting language) 来 指定 视图 在 水 平方 向 与 垂直 方向 上 的 排 布 形 陈 。 


本 节 将 会 演示 这 两 种 方式 ， 使 读者 明白 它们 的 写法 及 用 法 。 请 记 住 : 无 论 怎样 构建 约束 规则 ， 它 们 所 产生 的 结果 都 是 类 似 “y 关 系 mx+b” 这 样 的 关系 式 。 不 论 创 
建 了 何 种 约束 规则 ， 它 们 都 是 NSLayoutConstraint 类 的 成 员 。 


5.5.1 基本 约束 规则 声明 


NSLayoutConstraint 类 的 constraintWithltem: attribute: relatedBy: toltem: attribute: multiplier: constant: 方法 (这 方法 名 够 长 吧 ! ) 一 次 能 够 创建 
一 条 约束 规则 。 这 些 规则 可 以 把 一 个 视图 同 另 一 个 视图 关联 起 来 。 


这 个 方法 会 创建 出 严格 的 “view.attribute R view.attribute*multiplier+constant” 关 系 式 。 其 中 R 可 以 是 “等 于 (==) 、“ 大 于 等 于 (>=) 或 “小 于 等 
d" (<=). 


请 看 下 列 范 例 代码 : 


[self .view addConstraint: 
[NSLayoutConstraint 
constraintWithItem:textfield 
attribute:NSLayoutAttributeCenterX 
relatedBy:NSLayoutRelationEqual 
toltem:self.view 


attribute:NSLayoutAttributeCenterX 
multiplier:1.0f 
constant:0.0f]]; 


这 段 代 码 会 向 视图 控制 器 的 视图 (self.view) 里 添加 一 条 新 的 约束 规则 ， 它 会 把 文本 框 中 心 点 的 横 坐 标 与 本 视图 中 心 点 的 横 坐 标 对 齐 。 具 体 来 说 ， 就 是 在 两 个 视 
图 中 心 点 的 横 坐 标 (以 NSLayoutAttributeCenterX 属 性 来 表示 ) 之 间 设 立 等 同 (NSLayoutRelationEqual) 关系 。 放 大 信 数 是 1， 偏 移 量 是 0。 这 样 就 产生 了 下 面 的 关 
ES 


[textfield]’ s centerX= ([self.view]’ s centerX*1) +0 


这 个 关系 式 的 意思 是 : 请 把 本 视图 中 心 点 的 X 坐 标 与 文本 框 中 心 点 的 X 坐 标 对 齐 。UIView 的 addConstraint: 方法 会 把 这 条 约束 规则 添加 到 视图 之 中 ， 该 规则 与 其 
他 的 约束 规则 都 会 存放 在 视图 的 constraints 属 性 里 。 


5.5.2 ”用 可 视 化 格式 字符 串 声 明 约 束 规则 
上 一 节 演 示 了 如 何 创建 单条 约束 关系 。NSLayoutConstraint 类 里 还 有 个 方法 ， 可 以 根据 字符 串 来 创建 约束 规则 ， 这 种 字符 串 使 用 基于 文本 的 视觉 格式 语言 来 表示 
其 内 容 。 这 就 好 比 给 Objective-C 语 言 高 手 设 计 的 一 套 ASClI 符 号 图 (ASCII art) 。 请 看 下 面 这 个 例子 : 


[self.view addConstraints: [NSLayoutConstraint 
constraintsWithVisualFormat :@"V: [leftLabel]-15- [rightLabel]" 
options:0 
metrics:nil 
views:NSDictionaryOfVariableBindings(leftLabel, rightLabel)]]; 


上 面 这 行 代码 会 根据 可 视 化 格式 字符 串 的 内 容 创 建 出 一 套 约束 规则 ， 以 满足 其 中 的 关系 。 在 后 面 几 证 中 ， 我 们 将 会 多 次 看 到 这 种 字符 串 ， 它 们 用 来 表述 视图 在 横 
轴 (H) SOMA (V) 万 向 上 与 其 他 视图 的 关系 。 本 例 所 用 的 这 个 字符 串 的 意思 是 说 : 确保 rightLabel 出 现在 leftLabeI 下 方 15 点 处 。 

创建 这 种 格式 字符 串 的 时 候 要 注意 下 面 这 些 事 项 : 

AMH: AV: 前 组 来 指明 规则 所 针对 的 轴 。 

字符 事 里 指 代 视 图 的 变量 名 都 用 方 括号 括 起 来 。 

` 两 控件 之 间 的 固定 间距 用 左右 带 有 7-7 的 常数 来 表示 ， 例 如 -15-。 

- 本 例 没有 使 用 选项 (options 参 数 ) ， 不 过 开发 者 可 以 借 此 来 指定 对 齐 的 方向 是 从 左 至 右 、 从 右 至 左 还 是 从 头 至 尾 ， 本 章 前 面 讨论 过 这 个 问题 。 


- 本 例 也 没有 使 用 metrics 参 数 ， 开 发 者 可 以 把 一 份 字典 (NSDictionary) 传 进去 ， 并 在 其 中 提供 一 些 约束 规则 所 用 到 的 常量 ， 这 样 就 不 用 再 去 专门 创建 相关 的 格式 
字符 串 了 。 比 方 说 ， 我 们 想 令 两 个 文本 标签 之 间 的 间距 可 变 ， 那 么 请 将 本 例 中 的 15 替 换 成 某 个 指标 的 名 字 (例如 可 以 叫 作 labelOffset 之 类 的 ) ， 然 后 把 该 指标 的 值 放 在 
metrics 字 典 里 面 。 字 典 的 键 是 指标 的 名 称 ， 而 值 的 类 型 则 是 NSNumber。 传 入 这 样 一 个 字典 (例如 @{@"labelOffset"，(@15}) 比 每 次 用 到 一 种 宽度 时 都 去 创建 新 的 


NSString 实 例 要 简单 许多 。 


‘views: 参数 的 实际 意义 与 其 名 称 不 同 ， 它 不 是 个 包含 视图 的 数组 。 我 们 要 给 该 参数 传 入 含有 变量 绑 定 (variable binding) 的 字典 。 这 种 字典 会 把 作为 变量 名 的 字 


符 事 与 变 量 所 指 代 的 视图 关联 起 来 。 执 行 了 这 样 一 种 操作 之 后 ， 开 发 者 就 可 以 在 格式 字符 事 里 使 用 诸如 leftLabel 及 rightLabel 等 有 意义 的 符号 了 。 


用 格式 字符 串 来 构建 约束 规则 时 ， 总 会 产生 一 个 包含 若干 约束 规则 的 数组 。 某 些 格式 字符 串 相当 复杂 ， 另 外 一 些 则 比较 简单 。 我 们 不 太 容易 看 出 来 每 个 字符 串 到 
底 会 产生 多 少 条 约束 规则 。 请 注意 : constraintsWithVisualFormat 方 法 会 制作 出 能 够 满足 格式 字符 串 的 一 系列 约束 规则 ， 而 开发 者 要 把 这 些 规 则 全 都 添加 到 视图 里 面 
去 . 


5.5.3 SEHE 


Auto Layout 系 统 在 处 理 可 视 化 的 约束 字符 串 时 ， 需 要 把 leftLabel 及 rightLabel 等 视图 名 称 与 它们 所 表示 的 实际 视图 对 应 起 来 。 这 时 就 需要 用 到 变量 绑 定 了 ， 我 们 
通过 NSLayoutConstraint.h 文 件 里 定义 的 安 来 执行 变量 绑 定 ， 该 文件 是 UIKit 中 的 一 个 头 文 件 。 


NSsDictionaryOfVariableBindings( 安 以 任意 数量 的 局 部 变量 作 参 数 。 正 如 大 家 人 在 早 前 的 学 例 中 所 见 到 的 ， 这 些 参数 最 后 不 需要 添上 nil。 该 安 会 根据 传 入 的 变量 
构建 一 份 字典 ， 其 中 每 个 条 目的 键 都 是 变量 名 ， 而 值 则 是 变量 本 身 。 比 方 说 ， 如 果 执 行 下 面 这 条 语句 : 


NSDictionaryOfVariableBindings (leftLabel, rightLabel) 


那么 融会 构建 出 如 下 字典 : 


@{@"leftLabel":leftLabel, G"rightLabel":rightLabel] 


如 果 你 不 想 使 用 这 个 宏 ， 那 么 不 妨 手工 制作 一 份 字典 ， 并 把 它 传 给 使 用 可 视 化 格式 字符 串 的 约束 规则 构建 器 


[1] 指 的 是 constraintsWithVisualFormat 方 法 。 译 者 注 


5.6 ”格式 字符 串 


创建 约束 规则 时 所 用 的 格式 字符 串 遵循 下 面 这 套 基本 语法 : 


(«orientation»:)? («superview»«connection»)? <view>(<connection><view>) * 
(«connection»«superview»)? 


ASARTANIRE, MESURNZARETAGMORRS RR. Salem DAL, (BIcEs DIXESTECPRBRÁRISZDAELRISK. PLPN ARRE 
种 要 素 ， 并 提供 丰富 的 范例 来 演示 它们 的 用 法 。 


5.6.1 ĎE 


字符 串 开头 的 那个 可 选项 目 表 示 约 束 规则 所 针对 的 方向 (orientation) , H: 表示 水 平方 向 ，V: 表示 垂直 方向 。 意 思 是 说 ， 这 条 规则 所 约束 的 是 左右 方向 的 布局 
还 是 上 下方 向 的 布局 。 假 如 省 略 该 项 目 ， 那 么 默认 就 表示 左右 方向 。 比 方 说 有 这 样 一 个 约束 字符 串 :“"H: [view1][view2] "， 它 的 含义 融 是 把 view2 直 接 放 人 在 view1 右 
侧 。H 表 示 这 条 约束 规则 所 针对 的 方向 。 图 5-2 左 侧 那 张 示意 图 演示 了 运用 这 条 约束 规则 之 后 的 界面 布局 。 


Carrier = mmm Carrier = mm 


Action Action 


View 1 View 2 


图 5-2 4"H: [viewl]|iew2]" (AM) R&A) A"V: |[view1]-20-[view2]-20-[view3]" (A) RA) 相对 应 的 界面 布局 


接 下 来 再 看 一 个 垂直 布局 的 光 例 : "V: |[view1]-20-[view2]-20-[view3]"。 这 条 约束 规则 在 view1 与 其 下 方 的 view2 之 间 留 出 了 20 点 空 日 ， 然 后 又 在 view2 与 其 下 
方 的 view3 之 间 留 出 了 20 点 空白 。 图 5-2 右 侧 截 图 演示 了 运用 这 条 约束 规则 之 后 的 界面 布局 。 


如 果 不 继续 施加 约束 ， 那 么 仅 赁 目前 的 约束 规则 是 无 法 将 界面 准确 排 布 好 的 。Auto Layout 会 自行 决定 剩 下 的 部 分 ， 不 过 它 选 出 来 的 布局 通常 是 错误 的 。 在 左 侧 截 
图 中 ， 还 应 该 指定 垂直 方向 的 约束 规则 。 如 果 不 指定 ， 那 么 两 个 视图 融会 像 本 例 这 样 全 都 贴 厦 上 级 视图 的 顶 边 。 而 在 右 侧 截图 中 ， 还 应 指定 水 平方 向 的 约束 规则 。 如 
果 不 指定 ， 那 么 三 个 视图 融会 像 本 例 这 样 全 都 紧 贴 上 级 视图 的 左 界 。 


要 产生 图 ?-2 所 示 的 布局 效果 ， 需 要 分 别针 对 水 平方 向 和 垂直 方向 的 约束 规则 执行 : 


[self.view addConstraints: [NSLayoutConstraint 
constraintsWithVisualFormat:QG"H: [viewl] [view2]" 
options:0 metrics:nil 
views:NSDictionaryOfVariableBindings(viewl, view2)]]; 


[self.view addConstraints: [NSLayoutConstraint 
constraintsWithVisualFormat:@"V: | [view1] -20- [view2] -20- [view3]" 
options:0 metrics:nil 
views :NSDictionaryOfVariableBindings(viewl, view2, view3)]l; 


注意 上 面 这 个 格式 字符 串 开 头 的 竖 线 (|) . "REASARUXR DRE. RIIREERIASSRNS SA mee. UMROWEAA, SEAEBUESSE EAR 
或 垂直 方向 的 那个 标识 符 (比方 说 "V: |http://www.hzcourse.com/resource/readBook? 
path=/openresources/teach_ebook/uncompressed/15137/OEBPS/Text/..."K%"H: |http://www.hzcourse.com/resource/readBook? 
path=/openresources/teach_ebook/uncompressed/15137/OEBPS/Text/...") 。 要 是 它 出 现在 末尾 ， 那 么 就 放 在 字符 串 结束 处 的 那个 引号 之 前 
("http://www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15137/OEBPS/Text/...|") 。 在 iOS 7 系统 中 ， 如 果 把 本 
例 的 竖 线 省 略 掉 ， 那 么 视图 束 会 出 现在 状态 栏 及 导航 栏 的 下 方 。 


Qaz 调试 程序 时 ， 可 以 使 用 UIView 的 consttaintsAffectingLayoutForAxis: 方法 来 获取 影响 水 平 布局 或 垂直 布局 的 所 有 约束 规则 。 但 在 发 布 软件 产品 时 ， 请 勿 将 
该 方法 包含 在 内 。 它 不 是 供 正式 软件 使 用 的 ， 而 且 革 果 公 司 已 经 明确 表示 App Store 里 的 软件 不 应 该 调用 它 。 


5.6.2 ”连接 


在 视图 名 称 之 间 放 置 连接 (connection) ， 就 可 以 指定 视图 的 排 布 流程 了 。 空 连接 (也 就 是 把 连接 省 掉 ) 表示 紧 跟 其 后 。 


图 5-2 中 的 第 一 条 约束 规则 是 "H: [view1][view2]"， 它 里 面 就 用 到 了 空 连接 。 在 view1 的 右 方 括号 与 view2 的 左 方 括号 之 间 没 有 其 他 内 容 ， 这 就 表示 此 约束 规则 要 
求 view2 直 接 出 现在 view1 右 侧 。 


连 字符 (hyphen，-) 表示 一 小 段 固定 空间 。"H: [view1]-[view2]" 这 条 规则 就 用 连 字 符 来 表示 视图 之 间 的 连接 ， 它 会 在 view1 与 view2 之 间 留 出 标准 的 空 日 (这 
个 标准 由 苹果 公司 来 定 ) I 如 图 5-3 所 示 。 


如 果 在 两 个 连 字符 之 间 放 上 数值 常数 ， 那 么 就 可 以 精确 地 指定 间隔 尺寸 了 。 "H: [view1]-30-[view2] "这 条 约束 规则 会 在 两 个 视图 之 间 添 加 30 点 空白 ， 如 图 5-4 所 
示 。 这 上 段 空 日 看 上 去 要 比 由 单个 连 字 符 所 产生 的 小 缺口 冤 一 些 。 


图 5-3 "H: [view1]-[view2]" 这 条 规则 中 的 连接 会 在 两 视图 之 间 添 加 空白 


图 5-4 "H: [view1]-30-[view2]" 这 条 约束 规则 会 在 两 个 视图 之 间 插 入 30 点 的 固定 空白 ， 它 所 产生 的 间隔 要 比 上 一 条 约束 规则 宽 


"H: |Iview1]-[view2]|" 这 个 格式 字符 串 会 从 上 级 视图 开始 ， 逐 步 描述 水 平方 向 上 的 排 布 方式 。 上 级 视图 的 边界 紧 贴 着 view1 的 边界 ，view1 后 面 是 一 段 间 隔 ， 间 隔 
后 面 再 跟着 view2， 而 view2 的 后 边沿 也 紧 贴 着 上 级 视图 ， 整 个 效果 如 图 5-5 所 示 。 


这 条 约束 规则 会 将 view1 与 上 级 视图 左 对 齐 ， 同 时 将 view2 与 上 级 视图 右 对 齐 。 为 了 实现 这 种 布局 ， 系 统 必 须 放弃 一 些 原 有 的 设 定 才 行 。 要 么 调整 左边 那个 视图 的 
大 小 ， 要 么 调整 右边 那个 视图 的 大 小 ， 只 有 这 样 ， 才 能 满足 此 约束 规则 。 笔 者 运行 本 书 第 5 版 的 测试 程序 时 发 现 ， 系 统 调整 的 是 view1， 其 效果 如 图 5-5 所 示 ， 而 在 运行 
本 书 第 4 版 的 测试 程序 时 ， 发 现 系 统 调整 的 是 view2。 


很 多 情况 下 ， 我 们 不 想 令 视图 的 边界 紧 贴 着 上 级 视图 。 于 是 ， 可 以 指定 "H: |-[view1]-[view2]-| "规则 ， 它 与 上 面 那 条 规则 类 似 ， 只 是 会 在 上 级 视图 的 左边 界 与 
view1 的 左边 界 之 间 留 出 空白 ， 同 时 也 会 在 view2 的 右边 界 与 上 级 视图 的 右边 界 之 间 留 出 空白 ， 如 图 5-6 所 示 。 


图 5-5 "H: |[view1]-lview2]|" 这 条 约束 规则 要 求 左右 两 个 视图 必须 分 别 和 上 级 视图 的 左右 边界 对 齐 。 由 于 二 者 之 间 的 空白 是 固定 的 ， 所 以 至 少 要 调整 其 中 一 个 视图 的 宽 
度 才能 满足 此 规则 


图 5-6 "H: |-Fview1]-[view2]-|" 约 束 规则 会 在 视图 的 边界 与 上 级 视图 的 边界 之 间 留 出 空白 


对 于 视图 与 上 级 视图 之 间 的 空白 ， 其 尺寸 遵循 标准 的 1B/Cocoa Touch 布 局 规则 ， 苹 果 公 司 没有 在 iOS API 中 说 明 其 细节 。 视 图 边界 与 上 级 视图 边界 之 间 的 空白 一 
般 要 比 同 级 视图 之 间 的 默认 空 日 大 一 些 。 从 图 5-6 中 可 以 看 到 由 该 约束 规则 所 创建 的 两 种 空 日 之 间 的 区 别 。 


要 想 在 两 个 视图 之 间 插 入 灵活 的 空白 ， 也 是 有 办 法 来 实现 的 。 我 们 可 以 指定 两 者 的 关系 规则 (relation rule， 比 方 说 "H: |-[view1]- (>=0) -[view2]-|")， 使 其 
在 保持 各 自 尺寸 不 变 的 前 提 下 ， 既 能 相互 拉 开 一 段 距离 ， 又 能 在 自身 边界 与 上 级 视图 边界 之 间 留 出 空 日 ， 如 图 5-7 所 示 。 这 条 规则 的 意思 是 两 视图 之 间 至 少 有 0 个 点 的 
间隔 。 该 规则 使 得 系统 在 排 布 这 两 个 视图 的 时 候 可 以 灵活 地 调整 其 间距 。 笔 者 党 得， 这 条 关系 规则 里 面 所 使 用 的 那个 数字 应 该 小 一 些 才 对 ， 不 然 的 话 ， 可 能 会 无 意 间 
干扰 视图 的 其 他 几何 规则 。 


字符 串 里 面 当然 不 局 限于 一 到 两 个 视图 ， 也 可 以 放 入 三 四 个 ,或 者 更 多 的 视图 。 比 方 说 可 以 写 出 这 样 一 条 约束 规则 :"H: |-[view1]-[view2]- (>=5) -[view3]- 
|"。 第 三 个 视图 与 另外 两 个 视图 之 间 留 有 灵活 的 空白 。 图 5-8 演 示 了 满足 该 约束 规则 的 布局 方式 。 


图 5-7 "H: |-[viewl]- (7-0) -[view2]- | "规则 会 在 两 视图 之 间 留 出 灵活 的 空白 ， 使 两 者 在 保持 各 自 尺 寸 不 变 的 前 提 下 ， 能 够 相互 拉 开 一 段 距 离 


图 5-8 "H: [|-[viewl]-[view2]- (>=5) -view3]-|" 规 则 可 以 限定 三 个 视图 之 间 的 关系 


5./ sia 


[TEAR NERS! T PARRARI. KERNA (predicate) ， 它 是 对 视图 元 件 之 间 的 关系 所 下 的 断言 。 谓 词 需要 用 圆 括号 括 起 
来 。 比 方 说 ， 我 们 可 以 用 下 面 这 个 字符 串 来 规定 视图 的 尺寸 至 少 是 50 点 : 


[viewl (>=50) ] 


该 谓词 只 和 一 个 视图 有 关 。 请 注意 ， 这 个 谓词 出 现在 描述 视图 所 用 的 那 一 对 方 括号 之 内 ， 而 没有 像 上 一 节 那 样 出 现在 两 个 视图 之 间 的 连接 处 。 谓 词 并 不 局 限于 单 
个 标准 。 例 如 ， 我 们 可 以 用 类 似 的 规则 指明 视图 的 尺寸 必须 在 50 点 到 70 点 之 间 。 如 果 要 添加 复合 谓词 (compound predicate) ， 那 么 请 把 规则 的 各 个 部 分 用 逗号 隔 
开 : 


[viewl(>=50, <=70)] 


相对 关系 谓词 可 以 规定 视图 尺寸 的 增长 方式 。 如 果 想 令 某 视 图 尽量 占 满 其 上 级 视图 ， 那 么 可 以 宣称 其 尺寸 是 个 大 于 0 的 值 。 下 面 这 条 规则 会 在 水 平方 向 上 拉 伸 
view1， 使 其 在 保留 边界 空白 的 前 提 下 ， 尽 量 填 满 上 级 视图 : 


H: | - [view1(»20)]-| 


图 5-9 演 示 了 这 条 规则 的 布局 效果 。 


图 5-9 


"H: |-lview1(>=0)]-1" 规 则 给 视图 添加 了 一 个 灵活 的 谓词 ， 令 其 可 以 横 跨 上 级 视图 。 由 于 上 级 视图 的 边界 和 本 视图 的 边界 之 间 留 有 空白 ， 所 以 这 两 条 边线 之 间 会 


如 果 要 指定 的 是 等 同 关系 (==) ， 那 么 可 以 在 格式 字符 串 的 谓词 里 把 两 个 等 号 


等 号 省 掉 。 比 方 说 ，[view1 (==120) ] 等 价 于 [view1 (120) ], 而 [view1]- (==50) - 
[view2] 和 [view1]-50-[view2] 的 含义 是 相同 的 。 


5.7.1 IEn 


如 果 事 先 不 知道 常量 值 是 多 少 (也 就 是 说 ,我 们 无 法 预先 确定 常量 是 120 或 50 这 样 的 数值 ) ， 那 么 可 以 通过 metrics (指标 ) 字典 来 提供 该 值 。 在 调用 创建 约束 规 
则 的 方法 时 ， 我 们 把 该 字典 作为 metrics 参 数 传 进去 。 下 面 这 个 格式 字符 串 就 用 指标 描述 了 其 值 尚 不 明确 的 常量 


[viewl (>=minwidth) ] 


minwidth 这 个 占 位 符 必 须 能 够 映射 到 metrics 字 典 里 的 某 个 NSNumber 值 。 解 决 方案 5-2 的 constrainSize : 方法 详细 演示 了 指标 的 用 法 。 该 方法 在 创建 约束 规则 


的 时 候 ， 把 指标 所 对 应 的 值 放 在 了 一 份 字典 里 面 ， 大 家 可 以 通过 那 段 代码 明日 metrics 的 用 法 。 


5.7.2 AANER S] 


谓词 并 不 局 限于 数字 种 量 。 我 们 也 可 以 在 两 个 视图 的 尺寸 之 间 建 立 天 系 ， 以 保证 某 视 图 不 会 比 另外 一 个 视图 更 大 。 下 面 这 个 例子 限定 了 view2 的 尺寸 ， 使 其 在 目前 
所 涉及 的 这 条 轴 上 不 会 比 view1 更 大 : 


[view2{(<=VLew1l)] 


用 格式 字符 串 来 描述 视图 之 间 的 比较 关系 只 适用 于 一 些 简单 的 场合 。 如 果 想 建立 更 为 复杂 的 关系 ， 比 方 说 要 描述 中 心 点 、 顶 边 及 高 度 之 间 的 关系 ， 那 就 不 要 使 用 
可 视 化 的 格式 字符 串 了 ， 而 是 应 该 改 用 针对 项 目的 约束 构造 器 [1]。 


[1] 实际 上 指 的 就 是 constraintWithltem 方 法 。 译 者 注 


5.7.3 ”优先 级 


每 条 约束 规则 都 可 以 通过 at 符号 (@) 来 指定 优先 级 ， 符 号 后 面 可 以 是 数字 ， 也 可 以 是 某 项 指标 。 比 方 说 ,我 们 想 把 view1 的 尺寸 定 为 500 点 ， 但 又 想 把 这 条 规则 
的 优先 级 设置 得 低 一 些 ， 那 么 可 以 使 用 下 列 字符 串 : 


[viewl (500@10) ] 
优先 级 要 放 在 谓词 之 后 。 例 如 ， 下 面 就 是 一 个 在 谓词 中 绸 有 优先 级 的 格式 字符 串 : 


[viewl]-(»250830) - [view2] 


5.8 ”格式 字符 串 忌 结 


表 5-2 总 结 了 以 NSLayoutConstraint 类 的 constraintsWithVisualFormat: options: metrics: views: 方法 来 创建 约束 规则 时 所 用 的 格式 字符 串 的 各 个 部 件 。 
表 5-2 可视化 的 格式 字符 串 


类 型 格式 举 例 


(EZK SE Y [8] BK afe EE 7; Iu]. E H: V:[viewl]-15-[view2] 
排 布 V: 把 view2 WE view! JEW FH 15 点 处 


S 


K 型 格 zx 举 例 
[Viewl1l] 
视图 [item] 系统 会 在 传 给 views 参数 的 字典 里 面 寻 找 与 方 
括号 中 的 名 称 相 绑 定 的 UIVievw 实例 


上 级 视图 H: | [viewl1] | 
ner 令 view! 与 上 级 视图 同 宽 


H:[view1]-(»220)-[view2] 

4 view2 的 前 边沿 距离 viewl 的 后 边沿 至 少 
20 点 

H: [viewl (<=somewWidth) ] 


关系 


ge a dp 
指标 metric 指标 就 是 metrics 字 典 的 键 。 在 开发 者 经 由 
metrics 参数 传人 的 字典 当中 ， 必须 能 够 找到 与 
someWidth 及 mySpacing 相对 应 的 NSNumber fH 


H:[view1][view2] 
WX [item] [item] & FN 
sili | tremite 0 4 view! 的 后 边沿 紧 贴 view2 的 前 边沿 


[viewl1]- (»20)-[view2] 
弹性 空间 [item]- (»20)-[item] 这 两 个 视图 都 可 以 尽量 拉 开 距离 ,“ 其 间距 至 少 
是 0 点 ” 


[viewl]-[view2] 
国定 空间 [item]- [item] 在 两 个 视图 之 间 留 下 一 小 段 固 定 的 空白 (其 大 小 
是 8 点， 这 是 由 系统 定义 的 ) 


V:[view1]-20-[view2] 


定义 的 固定 空 bé B -fit 
H xe X KS ps xe as ph] [item]-gap-[item] A view2 的 顶部 距离 viewl 底部 20 点 
[item(size)] [viewl (50) ] 
EAE TE P. "A " . 
FA S EE nR E AE t B [item (==size)] 将 view! 在 当前 坐标 办 上 的 尺寸 设 为 50 点 
[viewl (>=50) ] 
"HEN [item(>=size) ] [viewl (<=50) ] 
最 小 或 最 大 宽度 / BJE , l v ad -" 
vov A TEBE / 高 度 [item(«-size)] 限定 viewl 在 这 条 坐标 轴 上 的 最 小 尺寸 或 最 大 
ANE 


PP [item (==item) ] | 
令 视 图 的 宽度 /高 度 与 男 [viewl (==view2) ] 


外 一 个 视图 相 匹 配 pe 令 两 个 视图 在 当前 坐标 轴 上 的 尺寸 相同 


紧 贴 上 级 视图 的 边界 | Totem] V:l[viewl] 
—— —— [stem | A> viewl 的 顶 边 紧 贴 上 级 视图 的 顶 边 


在 本 |- [view1] 
视图 的 边界 与 上 级 视 [item] hy, - l 

A 人 1 z 
图 的 边界 之 间 留 出 空白 在 当前 坐标 轴 的 方向 上 ， 给 viewl 的 边界 和 上 


级 视图 的 边界 之 间 留 出 固定 的 空白 C20 点) 
pol cedi leaning 


^E AS ESI Es H Be 391 ES E 3 - -[it 
m ER 在 视图 的 前 边沿 与 上 级 视图 的 边界 之 间 留 出 15 
界 之 间 留 出 一 定数 量 的 空 日 [item]-gap-| e zs s 


优先 级 [viewl (<=50@20) ] 
ipee 1000 ) evalue 4 viewl 在 当前 坐标 轴 上 的 最 大 尺寸 为 50 点 ， 
同时 把 这 条 规则 的 优先 级 降 到 很 低 (20 ) 


5.9 用 格式 字符 串 将 钢 图 对 齐 并 灵活 调整 其 尺寸 


[item(«-item)] 


过 约束 规则 ， 我 们 很 容易 就 能 指定 视图 的 对 齐 方式 : 


:"H: |fe" "H: [self]|". "V: |[sel 引 "及"V: [sel 和 fl" 这 4 种 格式 字符 串 分 别 产 生 左 对 齐 、 右 对 齐 、 顶 端 对 齐 及 底 端 对 齐 的 效果 。 


` 向 上 述 字 符 事 中 添加 表示 尺寸 关系 的 谓词 ， 即 可 实现 拉 伸 至 左边 界 、 拉 伸 至 右边 界 等 效果 : "H: |[self (>=0) J" "H: [self (>=0) J|" "V: |[self (2-0) ]" 


"V: [self (>=0) ]|". 


` 如 果 再 添 一 条 坚 线 ， 那 么 就 表示 在 整 条 坐标 轴 方 向 上 面 拉 伸 ， 也 就 是 令 视图 从 左 至 右 或 从 上 至 下 跨越 整个 上 级 视图 : "H: |[self (>=0) ]|" 或 "V: | 
[self (>=0) ] 


可 以 添加 连 字 符 ， 以 便 在 拉 伸 本 视图 的 时 候 ， 给 它 的 边界 与 上 级 视图 的 边界 之 间 留 出 一 些 空 阶 : H: |-[self (2-0) FI". "V: |-[self (2-20) ]-|"。 


5.10 ”处 理 约束 规则 的 流程 


系统 要 经 过 多 个 阶段 的 处 理 ， 才 能 把 视图 内 容 显 示 出 来 。 引 入 Auto Layout 机 制 之 前 ， 这 个 过 程 分 为 两 个 阶段 ， 即 布局 阶段 (layout phase) SERPE 
(rendering phase) 。 而 Auto Layout 机 制 则 在 这 两 个 传统 的 阶段 之 前 ， 又 添加 了 约束 阶段 (constraint phase) 。 


开发 者 可 以 实现 layoutSubviews 方 法 ， 以 便 在 布局 阶段 修改 视图 里 各 个 子 视图 的 几何 特征 。 当 iOS 认 定 某 视 图 的 布局 已 经 无 效 时 ， 就 会 调用 该 方法 ， 开 发 者 可 在 
其 中 手动 更 新 子 视图 的 排 布 方 式 。 除 了 系统 自行 调用 之 外 ， 开 发 者 可 以 手工 调用 setNeedsLayout 或 layoutlfNeeded 方 法 来 请 求 重 新 排版 。 前 者 是 个 比较 温和 的 请 
求 ，iOS 系 统 会 把 很 多 个 这 样 的 请 求 合并 起 来 ， 然 后 在 适当 的 时 机 调用 layoutSubviews 方 法 。 而 后 者 则 更 为 迫切 ， 调 用 了 它 之 后 ， 系 统 几 乎 立刻 就 会 执行 


layoutSubviews。 


在 泻 染 阶 段 ， 开 发 者 可 通过 实现 drawRect: 方法 来 完全 控制 视图 UI 的 绘制 。 当 系统 认定 视图 内 容 已 经 无 效 时 ， 它 会 调用 drawRect: 方法 ， 以 便 对 视图 进行 底层 
绘制 。 需 要 改变 泻 染 内 容 的 时 候 ， 开 发 者 可 以 通过 setNeedsDisplay 及 setNeeds-DisplayinRect: 方法 请 求 视图 重新 绘制 它 自己 ， 这 两 者 都 会 触 友 drawRect: 。 


fH f Auto Layout 机 制 之 后 ， 上 述 两 个 阶段 前 面 还 会 多 出 一 个 约束 阶段 (constraints phase) 。 通 过 实现 updateConstraints 方 法 ， 我 们 可 在 该 阶段 创建 并 更 新 
Auto Layout 系 统 所 使 用 的 约束 规则 。 与 布局 阶段 相似 ，iOS 系 统 可 以 自行 判定 某 个 视图 的 约束 规则 已 经 无 效 ， 从 而 开始 执行 约束 阶段 ， 而 另 一 方面 ， 开 发 者 也 可 以 手 
动 触发 此 过 程 ， 相 关 的 两 个 方法 叫 作 setNeedsUpdateConstraints 及 updateConstraintslfNeeded， 其 名 称 与 行为 与 刚才 说 的 那 两 组 方法 类 似 。 


如 果 履 写 了 视图 的 updateConstraints 方 法 ， 那 么 务必 要 在 该 方法 返回 之 前 调用 [Super updateConstraints]。 待 约束 阶段 结束 之 后 ，Auto Layout 会 适当 地 计算 出 
视图 内 所 有 子 视 图 的 几何 特征 。 


每 完成 一 个 阶段 ， 系 统 束 会 进入 下 一 阶段 。 也 就 是 说 ， 执 行 完 约束 阶段 之 后 ， 系 统 会 执行 布局 阶段 ， 而 执行 完 布 局 阶段 ， 又 会 执行 泻 染 阶 段 。 


这 种 阶段 处 理 方式 给 了 我 们 一 些 意 想不到 的 机 会 。 在 执行 布局 阶段 的 时 人 息 ， 系 统 已 经 在 约束 阶段 中 把 所 有 约束 规则 都 计算 好 了 ， 并 且 已 经 根据 这 些 规则 设 定 了 视 
图 的 几何 特征 。 而 在 布局 阶段 ， 则 可 以 用 一 种 与 约束 规则 相 违 背 的 方式 继续 修改 视图 的 几何 特征 。 另 外 ， 也 可 以 根据 由 约束 规则 所 产生 的 几何 特征 来 决定 视图 最 终 的 
样 狐 。 由 于 系统 在 上 个 阶段 已 经 把 约束 规则 算 好 了 ， 所 以 本 阶段 对 视图 样 狐 所 做 的 修改 会 一 直 保 留 到 下 一 轮 约束 阶段 为 止 。 请 勿 在 布局 阶段 修改 约束 规则 ， 否 则 系统 
又 会 触 上 相关 方法 来 更 新 约束 规则 ， 从 而 使 程序 在 约束 阶段 与 布局 阶段 乙 间 陷入 无 限 循环 。 


大 部 分 情况 下 都 用 不 到 这 些 “挂钩 ” 方 法 。 不 过 在 偶尔 用 到 它们 时 ， 这 些 方 法 会 展现 出 强大 的 灵活 度 与 控制 力 。 


5.11 管理 约束 规则 


无 论 约束 规则 是 如 何 创建 出 来 的 ， 它 们 都 属于 NSLayoutConstraint 类 。 开 发 者 可 通过 addConstraint: 方法 给 视图 和 逐条 添加 约束 规则 ， 也 可 以 把 多 条 规则 放 在 数 
组 里 ， 并 通过 addConstraints: 实例 方法 (注意 方法 名 最 后 的 s) 将 其 添加 到 视图 里 面 。 在 日 常 开 发 中 ， 我 们 经 常会 把 很 多 约束 规则 一 并 保存 在 某 个 数组 里 。 


存放 约束 规则 的 视图 目 然 应 该 是 离 规则 所 涉及 的 各 视图 最 近 的 那个 共同 福 移 。 在 其 身上 妆 配 约束 规则 的 视图 必须 是 规则 里 各 个 视图 的 共同 祖先 。 我 们 可 以 针对 
NSLayoutConstraint 编 写 category， 并 在 其 中 实现 一 个 方法 ， 用 程序 代码 把 该 规则 自动 委 配 到 正确 的 视图 上 面 。 这 个 功能 留 给 读者 作为 练习 。 


开 上 友 者 可 以 随时 添加 并 移 除 约 束 规 则 。removeConstraint: 及 removeConstraints: 方法 分 别 可 以 从 给 定 的 视图 中 移 除 一 条 约束 规则 或 一 组 约束 规则 。 由 于 这 两 
个 方法 是 基于 NSLayoutConstraint 对 象 来 运作 的 ， 所 以 它 的 执行 效果 可 能 与 开发 者 所 想 的 不 符 。 


比方 说 ,我 们 已 经 构建 了 一 条 居中 约束 规则 ， 并 将 其 添加 a 到 视图 里 面 了 。 如 果 现 在 又 构建 了 一 条 与 之 等 效 的 约束 规则 ， 然 后 通过 removeConstraint: KERE, 
那么 你 会 友 现 该 规则 并 没有 从 视图 中 删 挥 。 这 两 条 约束 规则 虽然 等 效 ， 但 并 不 是 完全 相同 的 两 个 对 象 。 下 列 代码 演示 了 这 个 问题 : 


[self .view addConstraint: 

[NSLayoutConstraint constraintWithItem:textField 
attribute:NSLayoutAttributeCenterX 
relatedBy:NSLayoutRelationEqual 
toItem:self.view 
attribute:NSLayoutAttributeCenterX 
multiplier:1.0f constant:0.0f]]; 

[self.view removeConstraint: 

[NSLayoutConstraint constraintWithItem:textField 

attribute:NSLayoutAttributeCenterX 


relatedBy:NSLayoutRelationEqual 
toItem:self.view 
attribute:NSLayoutAttributeCenterX 
multiplier:1.0f constant:0.0f]]; 


如 果 执 行 上 面 这 两 个 方法 调用 ， 那 么 self.view 实 例 中 就 会 含有 一 开始 所 构建 的 那 条 约束 规则 ， 但 是 removeConstraint: 方法 却 会 遭 到 忽略 。 移 除 不 归 该 视图 所 拥 
有 的 约束 规则 是 没有 效果 的 。 


有 两 种 解决 办 法 。 一 种 是 把 开头 添加 的 那 条 约束 规则 保存 到 局 部 变量 里 。 比 如 可 以 写成 下 面 这 样 : 


NSLayoutConstraint *myConstraint = 
[NSLayoutConstraint constraintWithItem:textField 

attribute:NSLayoutAttributeCenterX 
relatedBy:NSLayoutRelationEqual 
toItem:self.view 
attribute:NSLayoutAttributeCenterX 
multiplier:1.0f constant:0.0f]; 

[self.view addConstraint:myConstraint]; 


// later 
[self.view removeConstraint:myConstraint] ; 


另 一 种 是 采用 解决 方案 5-1 中 的 方法 来 比较 已 有 的 约束 规则 与 待 移 除 的 约束 规则 ， 并 把 数值 相符 者 从 视图 里 删 挥 。 


具体 采用 哪 种 办 法 要 看 约束 规则 是 静态 的 还 是 动态 的 (静态 约束 规则 是 在 视图 的 整个 生命 期 中 使 用 的 规则 ， 动 态 约束 规则 是 按 需 求 随时 指派 的 规则 ) 。 如 果 将 来 
可 能 要 移 除 某 条 约束 规则 ， 那 么 可 将 其 保存 到 局 部 变量 中 ， 以 便 稍 后 移 除 ， 也 可 以 采用 解决 方案 5-1 中 详 述 的 那 种 技巧 来 处 理 此 问题 。 


管理 约束 规则 时 ， 应 注意 下 面 几 点 : 


: 可 以 在 UIView 实 例 上 面 添 加 或 移 除 约束 规则 。 与 之 相关 的 几 个 核心 方法 是 : addConstraint: (addConstraints: ) ~ removeConstraint: | (removeConstraints: ) 及 


constraints. constraints 方 法 会 返回 包含 所 有 约束 规则 的 数组 。 


- 约束 规则 的 适用 范围 并 不 局 限于 容器 视图 ， 几 乎 所 有 视图 都 可 以 施加 约束 规则 。 (通过 名 为 tequiresConstraintBasedLayout 的 类 方法 ， 我 们 可 以 知道 这 种 视图 类 是 
不 是 必须 放 在 基于 约束 的 布局 系统 里 才能 够 正常 运作 。) 


` 如 果 要 以 编程 的 方式 为 子 视图 施加 约束 规则 ， 那 么 请 把 子 视图 的 translates-AutoresizingMaskIntoConstraints 属 性 关 挤 。 读 者 稍 后 就 能 在 本 章 的 范例 代码 中 看 到 这 个 


属性 ， 而 且 本 章 末 尾 的 5.17 节 也 会 深入 讨论 它 。 


5.12 AAS: 买 现 约束 规则 之 间 的 对 比 


所 有 的 约束 规则 都 遵循 同一 套 固 定 的 结构 ， 而 且 都 有 相关 的 优先 级 : 


view1.atttibute (relation) view2.attribute*multiplier+constant 


上 述 等 式 的 每 个 部 分 都 与 NSLayoutConstraint 对 象 的 属性 相对 应 ， 它 们 分 别 是 priorityl1]、firstltem、firstAttribute、relation、secondltem、second- 
Attribute、multiplier 与 constant。 通 过 这 些 属性 ， 我 们 很 容易 比 对 两 条 约束 规则 。 


UlView 会 把 约束 规则 当成 NSLayoutConstraint 对 象 来 保存 或 移 除 。 即 便 两 条 规则 所 描述 的 含义 相同 ， 只 要 其 内 存 位 置 不 同 ， 它 们 就 是 不 相等 的 。 如 果实 现 了 规则 
之 间 的 对 比 功能 ， 那 么 就 无 须 将 规则 专门 存放 到 变量 里 面 了 ， 而 是 可 以 通过 程序 码 随时 添加 并 移 除 它们 。 


解决 方案 5-1 编 写 了 三 个 方法 。constraint: matches: 方法 会 比较 两 条 约束 规则 的 相关 属性 ， 以 此 判断 二 者 是 否 相 同 。 请 注意 ， 在 比较 的 时 候 ， 我 们 只 考虑 等 式 
本 身 ， 而 不 考虑 优先 级 (如 果 读 者 想 添加 这 个 因素 ， 那 只 需 稍 微 修 改 一 下 代码 就 能 实现 ) ， 因 为 两 条 约束 规则 只 要 描述 的 是 同一 套 约束 方式 ， 那 么 无 论 开发 者 给 其 指 
定 何 种 优先 级 ， 它 们 实际 上 都 是 等 效 的 。 


还 有 两 个 方法 分 别 叫 作 constraintMatchingConstraint: 及 removeMatching-Constraint: ， 前 者 在 视图 里 查找 与 开发 者 所 给 规则 相 匹 配 的 首 条 约束 规则 ， 而 后 
者 则 把 此 约束 规则 从 视图 中 移 除 。 


解决 方案 5-1 会 把 某 条 约束 规则 从 视图 里 删除 ， 并 换 上 一 条 新 约束 规则 ， 这 样 的 话 ， 此 视图 就 会 从 上 级 视图 的 顶部 跑 到 上 级 视图 的 底部 了 。 对 于 本 例 这 种 简单 的 情 
况 来 说 ， 我 们 完全 可 以 把 约束 规则 保存 到 实例 变量 中 ， 并 在 稍 后 将 其 从 视图 里 移 除 。 不 过 ， 人 在 需要 管理 多 条 约束 规则 或 动态 移 除 某 约束 规则 的 时 候 ， 这 种 相似 约束 规 


则 的 查询 与 移 除 功能 还 是 非常 有 用 的 。 


Qi 解决 方案 5-1 针 对 UIView 类 编写 了 名 为 ConsttaintHelpet 的 categoty。 本 章 将 会 用 到 并 逐步 扩充 这 个 categoty， 笔 者 会 在 里 面 编写 一 些 工具 方法 ， 供 大 家 在 开 
发 自己 的 应 用 程序 时 使 用 。 


解决 方案 5-1 ”实现 约束 规则 之 间 的 对 比 


@implementation UIView (ConstraintHelper) 
// This ignores any priority, looking only at y (R) mx + b 
- (BOOL)constraint: (NSLayoutConstraint *)constraintl 
matches: (NSLayoutConstraint *)constraint2 


if (constraintl.firstItem !- constraint2.firstItem) return NO; 

if (constraintl.secondItem !- constraint2.secondItem) return NO; 

if (constraintl.firstAttribute !- constraint2.firstAttribute) return NO; 
if (constraintl.secondAttribute !- constraint2.secondAttribute) return NO; 
if (constraintl.relation !- constraint2.relation) return NO; 

if (constraintl.multiplier !- constraint2.multiplier) return NO; 

if (constraintl.constant !- constraint2.constant) return NO; 


return YES; 


// Find first matching constraint (priority ignored) 
- (NSLayoutConstraint *)constraintMatchingConstraint: 
(NSLayoutConstraint *)aConstraint 


for (NSLayoutConstraint *constraint in self.constraints) 
if ([self constraint:constraint matches:aConstraint]) 
return constraint; 


for (NSLayoutConstraint *constraint in self.superview.constraints) 
if ([self constraint:constraint matches:aConstraint]) 
return constraint; 
return nil; 


// Remove constraint 
- (void)removeMatchingConstraint: (NSLayoutConstraint *)aConstraint 


| 


NSLayoutConstraint *match - 
[self constraintMatchingConstraint:aConstraint] ; 
if (match) 


( 


[self removeConstraint:match] ; 
[self.superview removeConstraint:match] ; 


| 


@end 
获取 解决 方案 代码 
访问 https://github.com/erica/iOS-7-Cookbook 网 页 ， 并 打开 “C05Constraints” 文 件 夹 ， 即 可 找到 与 本 章 中 的 解决 方案 相对 应 的 完整 范例 项 目 。 
用 动画 来 表现 约束 规则 的 变更 过 程 


解决 方案 5-1 会 把 “本 视图 与 上 级 视图 顶端 对 齐 (或 帮 端 对 齐 ) ”这 条 约束 规则 删 探 ， 并 添加 一 条 反 向 约束 规则 ， 以 此 来 移动 当前 视图 。 下 面 这 段 代 码 是 从 解决 方 
案 5-1 里 节选 的 ， 它 可 以 令 view1 从 上 级 视图 的 顶端 移 到 底部 : 


NSLayoutConstraint * constraintToMatch - 

[NSLayoutConstraint constraintWithItem:viewl 
attribute:NSLayoutAttributeTop 
relatedBy:NSLayoutRelationEqual toItem:self.view 
attribute:NSLayoutAttributeTop multiplier:1.0f constant:0]; 

[self.view removeMatchingConstraint: constraintToMatch]; 


NSLayoutConstraint * updatedConstraint - 
[NSLayoutConstraint constraintWithItem:viewl 
attribute:NSLayoutAttributeBottom 


relatedBy:NSLayoutRelationEqual toItem:self.view 
attribute:NSLayoutAttributeBottom multiplier:1.0f constant:0]; 
[self.view addConstraint:updatedConstraint]; 


[self.view layoutIfNeeded] ; 


最 后 一 行 的 layoutIfNeeded 语 句 会 令 Auto Layout 系 统 重新 处 理 约束 规则 ， 并 把 更 新 之 后 的 视图 泻 染 出 来 。 不 过 ， 这 样 做 出 来 的 切换 效果 有 些 突 几 。 实 际 上 ， 只 
需 添加 几 行 简单 的 代码 ， 融 能 把 这 个 过 程 用 动画 表现 出 来 。 我 们 需要 做 的 融 是 把 调用 layoutlfNeeded 的 那 行 语句 放 在 块 里 ， 并 传 给 animateWithDuration 方 法 的 


animations 参 数 : 


[UIView animateWithDuration:0.3 animations:^[ 
[self.view layoutIfNeeded]; 


H; 


XH AMI LES IRAE Bea RWS, C SERERE ETIE SUE RAT EERE]. 


[1] 相当 于 规则 的 优先 级 。 


译 者 注 


5.13 ”解决 方案 : 创建 尺寸 固定 是 受 规则 约束 的 视图 


使 用 约束 规则 的 时 候 ， 要 以 一 种 新 的 思维 方式 来 考虑 视图 的 布局 。 现 在 我 们 不 是 像 原 来 那样 通过 设置 框架 来 固定 其 尺寸 和 位 置 ， 而 是 要 来 用 一 套 全 新 的 思路 ， 通 
过 约束 规则 来 限定 视图 的 布局 。 


在 使 用 Auto Layout 之 前 ,我 们 会 用 下 面 这 个 工具 方法 创建 标签 控件 : 


- (UILabel *)createLabelTheOldWay: (NSString *)title 


| 


UILabel *label - [[UILabel alloc] 
initWithFrame:CGRectMake(0.0f, 0.0f, 100.0f, 100.0f)1]; 

label.textAlignment - NSTextAlignmentCenter; 

label.text - title; 


return label; 


但 在 使 用 了 Auto Layout m, SUPPEA RIENE. efi JT- FRU RJ RENEE, MEARE AMARA, LAC yaa 
大 小 和 位 置 。 


5.13.1 ZtRHtranslatesAutoresizingMasklntoConstraints 
autoresizing (自动 调整 尺寸 ) 是 一 种 由 IB 所 使 用 的 struts-and-springs 式 布局 工具 ， 它 也 可 以 指 程序 代码 里 用 到 的 一 些 相关 标志 ， 例 如 
UIViewAutoresizingFlexibleWidth 等 。 如 果 要 通过 这 些 手段 来 指定 视图 的 自动 调整 行为 ， 那 么 在 定义 约束 规则 的 时 候 ， 融 不 应 该 再 引用 该 视图 了 。 


使 用 约束 规则 之 前 ， 应 该 移 茶 用 视图 中 的 有 关 属 性 ， 该 属性 会 把 涉及 自动 调整 功能 的 掩 码 自 行 转换 为 约束 规则 。 如 果 局 用 该 属性 ， 那 么 视图 会 通过 与 自动 调整 功 
能 有 天 的 掩 码 来 参与 到 Auto Layout 系 统 里 面 ， 要 是 茶 用 己 ， 开 友 者 融 需 要 目 己 添加 约束 规则 。 


这 个 与 约束 规则 有 关 的 属性 叫 作 translatesAutoresizingMasklntoConstraints。 如 果 将 其 设 为 NO， 我 们 就 可 以 放心 地 向 视图 中 添加 自己 的 约束 规则 ， 而 不 必 担 
心 它 会 与 系统 自动 生成 的 规则 相 冲 突 。 这 一 点 非常 重要 。 若 是 尚未 禁用 该 属性 就 直接 开始 添加 约束 ， 则 可 能 会 引发 冲突 。 由 自动 调整 功能 所 生成 的 那些 规则 无 法 与 开 
发 者 自己 编写 的 这 些 规则 和 平 共 处 。 如 果 程 序 在 运行 的 时 候 出 现 了 此 问题 ， 就 会 产生 下 面 这 样 的 错误 消息 : 


2012-06-24 15:34:54.839 HelloWorld[64834:c07] Unable to simultaneously satisfy 
constraints. 

Probably at least one of the constraints in the following list is one you don't 
want. Try this: (1) look at each constraint and try to figure out which you don't 
expect; (2) find the code that added the unwanted constraint or constraints and 
fix it. (Note: If you're seeing NSAutoresizingMaskLayoutConstraints that you don't 
understand, refer to the documentation for the UIView property 


translatesAutoresizingMaskIntoConstraints) 
人 
"«NSLayoutConstraint:0x6ec9430 H: [UILabel:0x6ec5210(100)]»", 
"«NSAutoresizingMaskLayoutConstraint:0x6b8e2a0 
h=--& v=--& H: [UILabel:0x6ec5210(0)]»" 
) 
Will attempt to recover by breaking constraint 
«NSLayoutConstraint:0x6ec9430 H: [UILabel :0x6ec5210(100)]> 
Break on objc exception throw to catch this in the debugger. 


在 基于 自动 调整 功能 的 布局 和 基于 约束 规则 的 布局 乙 间 进 行 抉择 是 编写 代码 时 的 一 项 重要 任务 。 


5.13.2 ” 令 视 图 出 现在 上 级 视图 汽 围 内 


解决 方案 5-2 中 的 第 一 个 方法 叫 作 constrainWithinSuperviewBounds， 它 会 把 某 视 图 完全 放 在 其 上 级 视图 的 范围 内 。 该 方法 创建 了 四 条 约束 规则 来 保证 这 一 点 。 
其 中 一 条 规则 要 求 本 视图 的 左边 界 必须 与 上 级 视图 的 左边 界 对 齐 ， 或 位 于 其 右 侧 ， 另 一 条 规则 要 求 本 视图 的 顶端 必须 与 上 级 视图 的 顶端 对 齐 ， 或 位 于 其 下 方 ， 其 余 两 
条 也 与 之 相似 。 


之 所 以 要 创建 这 个 方法 ， 是 因为 在 约束 规则 比较 宽松 的 系统 中 ， 视 图 的 原点 完全 有 可 能 是 负 值 ， 从 而 导致 目 己 出 现在 屏幕 之 外 而 不 为 用 户 所 见 。 该 方法 的 基本 意 
思 是 : 在 排 布 这 个 子 视 图 的 位 置 时 ， 请 考虑 到 (0，0) 原点 与 上 级 视图 的 尺寸 ， 而 不 要 把 它 排 布 到 上 级 视图 外 面 去 。 


在 日 常 开 友 中 ， 我 们 不 一 定 非 要 设置 这 套 约 束 规则 。 但 在 刚 开始 接 触 约束 并 想 通 过 代码 来 研究 它 的 时 候 ， 这 种 约束 规则 就 显得 非常 有 用 了 。 它 能 够 确保 本 视图 不 
会 越 出 上 级 视图 的 范围 ， 从 而 令 我 们 可 以 测试 其 他 各 项 约束 规则 ， 并 观察 这 些 规则 之 间 的 关系 。 


此 外 ， 在 熟悉 了 约束 系统 之 后 ， 我 们 可 能 还 想 给 程序 添加 一 些 调试 用 的 反馈 代码 ， 以 便 在 主 视 图 加 载 完毕 并 运用 了 约束 规则 之 后 ， 能 够 知道 我 们 自己 的 视图 位 于 
何 处 。 比 方 说 ， 可 以 把 下 面 这 个 for 循 环 添加 到 viewDidAppear: 方法 中 : 


- (void)viewDidAppear: (BOOL)animated 


| 


[super viewDidAppear:animated]; 
for (UIView *subview in self.view.subviews) 
NSLog(@"View (%d) location: %@", 
[self.view.subviews indexOfObject:subview], 
NSStringFromCGRect (subview.frame)); 


5.13.3 ”限定 视图 的 尺寸 


解决 方案 5-2 的 第 二 个 方法 叫 作 constrainSize: ， 它 会 把 视图 的 尺寸 固定 为 开 友 者 所 指定 的 CGSize。 人 在 定义 约束 规则 的 时 候 ， 这 是 一 种 经 常会 用 到 的 操作 。 我 们 
不 能 再 像 原来 那样 设 定 视图 的 框架 。 另 外 也 请 记得 : 这 些 约束 规则 都 只 是 一 种 请 求 ， 未 必 忌 是 与 最 终 的 布局 完全 相符 。 假 如 没有 合理 地 设计 约束 规则 ， 那 么 宽度 为 100 
个 点 的 文本 框 在 最 终 的 程序 界面 里 其 宽度 可 能 会 变 成 107 个 点 ， 或 是 更 粳 。 


我 们 可 以 在 约束 规则 中 针对 某 视 图 来 指定 其 宽度 或 局 度 ， 然 而 这 两 条 规则 所 要 用 到 的 宽度 值 和 高 度 值 是 不 能 预 判 的 ， 因 为 constrain9ize: 方法 要 适用 于 各 种 视图 
才 行 。 于 是 ， 我 们 把 这 两 个 值 先 放 在 metrics (指标 ) 字典 里 ， 然 后 再 传 给 constraints-WithVisualFormat。 所 谓 指 标 ， 其 实 就 是 约束 规则 里 所 用 到 的 一 些 数值 变量 。 


这 两 条 规则 所 用 的 两 个 指标 分 别 叫 作 theHeight 和 和 theWidth， 这 些 名 称 完全 可 以 随意 选取 。 开 发 者 应 该 把 字符 串 作 为 键 (key) ， 放 在 传 给 metrics: 参数 的 字典 
里 。 在 调用 创建 约束 规则 的 那个 方法 时 ， 把 这 个 字典 传 进去 。 指 标 里 的 每 个 键 必须 出 现在 这 份 字典 中 ， 而 且 它 所 对 应 的 值 必须 是 个 NSNumber,。 


方法 里 的 两 条 约束 规则 设 定 了 我 们 所 期 望 的 视图 宽度 及 视图 高 度 。 两 个 格式 字符 串 (EEH: [self (theWidth) ]" 及 "V: [self (theHeight) ]") 分 别 告诉 约束 
系统 当前 这 个 视图 在 横 轴 和 纵 轴 上 的 尺寸 应 该 是 多 少 。 


第 三 个 方法 叫 作 constrainPosition : ， 它 会 构建 两 条 约束 规则 ， 用 于 确定 本 视图 的 原点 在 上 级 视图 里 的 位 置 。 请 注意 看 该 方法 在 调用 
constraintsWithVisualFormat 时 是 如 何 使 用 constant 人 参数 的 。 


5.13.4 ”把 前 面 各 节 内 容 拼 闭 起 来 


本 书 前 面 曾 经 列 出 了 一 个 方法 ， 它 以 传统 方式 创建 标签 控件 ， 有 了 上 述 工具 之 后 ， 我 们 便 可 采用 Auto Layout 来 改写 那个 方法 ， 新 方法 比 原版 本 强大 许多 : 


- (UILabel *)createLabelWithTitle: (NSString *)title 
onParent: (UIView *)parentView 


UILabel *label - [[UILabel alloc] init]; 
label.textAlignment - NSTextAlignmentCenter; 
label.text - title; 


// Add label to parent view so constraints can be added 
[parentView addSubview:label]; 


// Turn off automatic translation of autoresizing masks into constraints 


label.translatesAutoresizingMaskIntoConstraints = NO; 


// Add constraints 
[label constrainWithinSuperviewBounds] ; 


[label constrainSize:CGSizeMake(100, 100)]; 
[label constrainPosition:CGPointMake(50, 50)]; 


return label; 


我 们 要 用 约束 规则 把 上 述 标签 和 其 上 级 视图 联系 起 来 ， 然 而 在 添加 规则 之 前 ， 必 须 先 把 标签 控件 作为 子 视图 放 到 上 级 视图 里 。 在 其 上 添加 约束 规则 的 那个 视图 和 
规则 中 所 提 到 的 视图 必须 位 于 同一 个 视图 体系 中 ， 而 且 规 则 里 的 那些 视图 彼此 之 间 也 必须 处 在 这 个 体系 里 ， 否 则 融会 引发 意 想 不 到 的 行为 ， 甚 至 会 令 程序 在 运行 的 时 
候 朋 溃 。 所 以 ， 我 们 有 时 可 能 要 稍稍 调整 一 下 代码 顺序 ， 比 方 说 ， 上 面 这 个 方法 融会 在 添加 约束 规则 之 前 ， 先 把 标 等 放 在 上 级 视图 中 。 


无 论 按 何 种 顺序 来 调整 视图 的 生成 代码 ， 我 们 都 要 遵循 下 列 步 又: 首先 创建 视图 ， 然 后 将 其 添加 到 上 级 视图 里 ， 接 下 来 禁用 
translatesAutoresizingMasklntoConstraints， 最 后 运用 必要 的 约束 规则 。 


解决 方案 5-2 用 最 基本 的 约束 规则 来 限定 视图 的 尺寸 


@implementation UIView (ConstraintHelper) 


| 


(void)constrainWithinSuperviewBounds 


(!self.superview) return; 


// Constrain the top, bottom, left, and right to 
// within the superview's bounds 
[self.superview addConstraint: [NSLayoutConstraint 


constraintWithItem:self attribute:NSLayoutAttributeLeft 
relatedBy:NSLayoutRelationGreaterThanOrEqual 
toltem:self.superview attribute:NSLayoutAttributeLeft 
multiplier:1.0f constant:0.0f]]; 


[self.superview addConstraint: [NSLayoutConstraint 


constraintWithItem:self attribute:NSLayoutAttributeTop 
relatedBy:NSLayoutRelationGreaterThanOrEqual 
toItem:self.superview attribute:NSLayoutAttributeTop 
multiplier:1.0£ constant:0.0£f]].: 


[self.superview addConstraint: [NSLayoutConstraint 


constraintWithItem:self attribute:NSLayoutAttributeRight 
relatedBy:NSLayoutRelationLessThanOrEqual 
toItem:self.superview attribute:NSLayoutAttributeRight 
multiplier:1.0f constant:0.0f]]; 


[self.superview addConstraint: [NSLayoutConstraint 


constraintWithItem:self attribute:NSLayoutAttributeBottom 


relatedBy:NSLayoutRelationLessThanOrEqual 
toItem:self.superview attribute:NSLayoutAttributeBottom 
multiplier:1.0f constant:0.0f]]; 


- (void) constrainSize: (CGSize) aSize 


| 


NSMutableArray *array - [NSMutableArray arrayl; 


// Fix the width 

[array addObjectsFromArray: [NSLayoutConstraint 
constraintsWithVisualFormat :@"H: [self (theWidth@750) ]" 
options:0 metrics:@{@"theWidth" :@(aSize.width) } 
views :NSDictionaryOfVariableBindings(self)]]; 


// Fix the height 

[array addObjectsFromArray: [NSLayoutConstraint 
constraintsWithVisualFormat:@"V: [self (theHeight@750)]" 
options:0 metrics:@{@"theHeight":@(aSize.height) } 
views :NSDictionaryOfVariableBindings(self)]]; 


[self addConstraints:array] ; 


- (void) constrainPosition: (CGPoint) aPoint 


| 


if (!self.superview) return; 
NSMutableArray *array - [NSMutableArray arrayl; 


// X position 

[array addObject: [NSLayoutConstraint constraintWithItem:self 
attribute:NSLayoutAttributeLeft relatedBy:NSLayoutRelationEqual 
toItem:self.superview attribute:NSLayoutAttributeLeft 
multiplier:1.0f constant:aPoint.x]]; 


// X position 

[array addObject: [NSLayoutConstraint constraintWithItem:self 
attribute:NSLayoutAttributeTop relatedBy:NSLayoutRelationEqual 
toItem:self.superview attribute:NSLayoutAttributeTop 
multiplier:1.0f constant:aPoint.y]]; 


[self.superview addConstraints:array]; 


} 


@end 


5.14 ”解决 方案 : 将 两 个 钢 图 居中 对 章 
如 果 想 把 两 个 视图 居中 对 齐 ， 可 以 将 某 视图 的 中 心 点 属性 (也 就 是 centerX 及 centerY) 同 其 容器 的 对 应 属性 关联 起 来 。 解 决 方案 5-3 里 面 有 两 个 方法 可 以 获取 某 视 
图 的 上 级 视图 ， 并 在 这 两 个 视图 的 中 心 点 之 间 施 加 等 同 关系 。 


请 注意 ， 这 些 约束 规则 是 添加 在 上 级 视图 而 不 是 子 视图 身上 的 ， 这 是 因为 我 们 不 能 在 约束 规则 里 引用 视图 所 在 子 树 (subtree) 之 外 的 其 他 视图 。 若 是 那样 做 ， 则 
会 引发 下 列 错误 


2012-06-24 16:09:14.736 HelloWorld[65437:c07] *** Terminating app due to uncaught 
exception 'NSGenericException', reason: 'Unable to install constraint on view. 
Does the constraint reference something from outside the subtree of the view? 
That's illegal. constraint:«NSLayoutConstraint:0x6b6ebf0 UILabel:0x6b68e40.centerY 
== UIView:0x6b64a00.centerY» view:«UILabel: 0x6b68e40; frame = (0 0; 0 0); text = 
'View 1'; clipsToBounds - YES; userInteractionEnabled - NO; layer - «CALayer: 
0x6b67220»»' 


libc++abi.dylib: terminate called throwing an exception 
下 面 是 两 条 简单 的 原则 : 
- 创建 约束 规则 的 时 候 ， 如 果 规 则 所 涉及 的 菜 个 视图 是 另 一 个 视图 的 上 级 视图 ， 那 么 就 把 规则 添加 到 这 个 上 级 视图 里 。 
` 如 果 用 格式 化 字符 串 来 创建 约束 规则 ， 而 字符 囊 里 面 又 包含 表示 上 级 视图 的 坚 线 ， 那 么 就 把 规则 添加 到 对 应 的 上 级 视图 里 。 


解决 方案 5-3 ”用 约束 规则 来 实现 视图 的 居中 对 齐 


@implementation UIView (ConstraintHelper) 
- (void)centerHorizontallyInSuperview 


| 


if (!self.superview) return; 


[self.superview addConstraint: [NSLayoutConstraint 
constraintWithItem:self attribute:NSLayoutAttributeCenterX 
relatedBy:NSLayoutRelationEqual 
toItem:self.superview attribute:NSLayoutAttributeCenterX 
multiplier:1.0f constant:0.0f]]; 


- (void)centerVerticallyInSuperview 


| 


if (!self.superview) return; 


[self.superview addConstraint: [NSLayoutConstraint 
constraintWithItem:self attribute:NSLayoutAttributeCenterY 
relatedBy:NSLayoutRelationEqual 
toltem:self.superview attribute:NSLayoutAttributeCenterY 
multiplier:1.0f constant:0.0f]]; 


@end 


5.15 ”解决 方案 : 设 定 宽 高 比 


在 约束 规则 中 使 用 放大 倍数 ， 也 融 是 等 式 y=m*x+b 中 的 m， 即 可 设置 视图 的 宽 高 比 。 解 决 方案 5-4 演 示 了 如 何 通过 m 值 来 设 定 遍 宽 比 ， 并 将 视图 高 度 (y) 与 宽度 
(x) 联系 起 来 。 解 决 方案 5-4 人 在 视图 的 宽度 与 高 度 之 间 构 建 了 NSLayoutRelationEqual 天 系 ， 并 把 宽 高 比 用 作 放大 倍数 。 


为 了 切换 宽 高 比 ， 这 条 解决 方案 会 把 设置 好 的 约束 规则 保存 到 NSLayoutCons-traint 型 的 aspectConstraint 变 量 里 。 用 户 每 次 把 比例 从 16: 9 切换 到 4: 3 或 是 切换 
回去 时 ， 这 个 解决 方案 都 会 将 前 一 条 约束 规则 从 视图 里 移 除 ， 然 后 创建 新 规则 并 将 其 保存 起 来 。 创 建新 规则 的 时 候 要 设置 适当 的 放大 倍数 ,创建 好 之 后 ， 还 要 将 其 添 
加 到 视图 里 面 。 

我 们 既 想 令 视图 的 宽度 和 高 度 可 以 灵活 变化 ， 又 想 使 其 保持 一 定 的 尺寸 ， 所 以 ， 这 条 解决 方案 的 createLabe| 方 法 需要 做 两 件 事 。 首 先 ， 要 用 谓词 来 限定 宽度 及 高 
度 ， 它 请 求 系统 把 宽度 和 高 度 都 至 少 设 为 300 个 点 。 其 次 ， 要 给 这 一 请 求 指定 优先 级 。 我 们 把 优先 级 设 定 得 比较 高 (750) ， 但 是 并 没有 设 定 成 非 满足 不 可 (1000) , 
这 样 就 给 约束 系统 留 下 了 继续 调整 布局 的 余地 。 做 完 这 两 件 事 之 后 ， 我 们 就 实现 了 一 套 能 够 实时 调整 宽 高 比 的 程序 界面 ， 而 且 程 序 还 可 以 在 运行 的 时 候 动态 改变 其 布 
局 。 


为 了 令 代 码 读 起 来 容易 一 些 ， 我 们 把 创建 约束 规则 的 语句 直接 写 在 了 解决 万 案 5-4 里 ， 实 际 上 ， 只 需 稍 加 修改 ， 束 可 以 把 限定 宽 高 比 的 功能 添加 到 名 为 


ConstraintHelperfcategory#, 


限定 宽 高 比 的 约束 规则 也 可 以 用 来 保持 某 张 图 像 的 横 纵 比例 。 视 图 的 contentMode 可 能 无 法 完全 准确 地 设 定 图 像 的 横 纵 比 。 我 们 可 以 通过 Ullmage 的 size 属 性 得 
知 图 像 尺 寸 ， 然 后 用 其 宽度 除 以 高 度 ， 并 据 此 创建 出 符合 横 纵 比 的 约束 规则 来 。 


解决 方案 5-4 ”创建 限定 宽 高 比 的 约束 规则 


- (UILabel *)createLabelWithTitle: (NSString *)title onParent: (UIView *)parentView 
{ 

UILabel *label = [[UILabel alloc] init]; 

label.textAlignment = NSTextAlignmentCenter; 

label.text = title; 

label.backgroundColor = [UIColor greenColor]; 

[parentView addSubview:label]; 


// Turn off automatic translation of autoresizing masks into constraints 
label.translatesAutoresizingMaskIntoConstraints - NO; 


// Add constraints 

[label constrainWithinSuperviewBounds]; 

[label addConstraints: [NSLayoutConstraint 
constraintsWithVisualFormat :@"H: [label (>=theWidth@750) ]" 
options:0 metrics:@{@"theWidth":@300.0} 
views :NSDictionaryOfVariableBindings (label) ]]; 

(label addConstraints: [NSLayoutConstraint 
constraintsWithVisualFormat :@"V: [label (>=theHeight@750) }" 
options:0 metrics:@{@"theHeight" :@300.0} 
views :NSDictionaryOfVariableBindings (label) ]]; 

[label centerInSuperview]; 


return label; 


- (void)toggleAspectRatio 
| 
if (aspectConstraint) 


[self.view removeConstraint:aspectConstraint]; 


if (useFourToThree) 
aspectConstraint = [NSLayoutConstraint 
constraintWithItem:viewl 
attribute:NSLayoutAttributeWidth 
relatedBy:NSLayoutRelationEqual toItem:viewl 
attribute:NSLayoutAttributeHeight 
multiplier:(4.0f / 3.0f) constant:0.0f]; 


else 
aspectConstraint = [NSLayoutConstraint 
constraintWithItem:viewl 
attribute:NSLayoutAttributeWidth 
relatedBy:NSLayoutRelationEqual toItem:viewl 
attribute:NSLayoutAttributeHeight 
multiplier:(16.0f / 9.0f) constant:0.0f]; 


[self.view addConstraint:aspectConstraint]; 
useFourToThree - !useFourToThree; 


5.16 ”解决 方案 : 响应 屏幕 方向 的 变 


设备 屏幕 的 几何 特征 也 会 影响 界面 的 布局 方式 。 比 方 说 ， 当 设备 处 在 横 屏 状态 的 时 候 ， 垂 直方 向 上 束 没 有 太 多 的 空间 可 以 排 布 内 容 。 请 看 图 ?-10。 坚 屏 状态 
下 ，iTunes 专 辑 封面 会 出 现在 屏幕 上 方 ， 然 后 是 专辑 名 称 及 歌手 名 称 ， 最 下 面 是 写 有 专辑 价格 的 Buy (购买 ) 按钮 。 而 在 横 屏 状态 下 ， 专 辑 封 面 则 位 于 屏幕 雹 方 ， 专 辑 
名 称 、 歌 手 名 称 及 Buy 按 钮 排列 于 右 下 角 。 


为 了 适应 这 两 种 布局 ， 我 们 必须 根据 屏幕 方向 的 变更 情况 来 修改 约束 规则 ， 并 重新 排版 。 解 决 方案 5-5 中 的 updateViewControllerConstraints 方 法 能 够 依照 当前 
的 屏幕 方向 来 刷新 约束 规则 ， 它 会 把 已 有 的 规则 全 部 移 除 ， 并 设置 新 的 约束 。 我 们 应 该 在 willAnimateRotationTolnterfaceOrientation: duration: 里 调用 此 方法 。 
这 样 所 产生 的 效果 融 可 以 和 界面 里 的 其 他 动画 效果 平滑 地 融合 起 来 。 另 外 要 注意 ， 系 统 是 在 把 视图 控制 器 的 interfaceOrientation 属 性 设置 好 之 后 ， 再 去 调用 
willAnimate-RotationTolnterfaceOrientation 的 ， 而 不 是 像 willRotateTolnterfaceOrientation: duration: 方法 那样 在 该 属性 变更 之 前 回调 。 这 样 的 
话 ，updateViewController-Constraints 方 法 所 查询 到 的 界面 方向 本 身 就 已 经 是 正确 的 界面 方向 了 ， 我 们 可 以 据 此 生成 适当 的 约束 规则 。 


Carrier > 


Carrier 全 11:40 PM 
< iTunes Top Albums 


WA prs To THE T000 TIMES | 


Here's to the Good Times 


Florida Georgia Line 


$9.99 | OW Here's to the Good Times 


WR ucnrES TO THE GOOO THES | 


Florida Georgia Line 


$9.99 


图 5-10 ”同一 份 内 容 的 重 直 排版 和 水 平 排版 
解决 方案 5-5 使 用 了 几 个 与 约束 规则 有 天 的 安 ， 笔 者 将 在 本 章 末 尾 详细 解释 它们 。 


解决 方案 5-5 ”根据 屏幕 方向 来 更 新 视图 的 约束 规则 


- (void)updateViewControllerConstraints 


| 


[self.view removeConstraints:self.view.constraints]; 


NSDictionary *bindings - NSDictionaryOfVariableBindings( 
imageView, titleLabel, artistLabel, button); 


if (IS IPAD || 
UIDeviceOrientationIsPortrait(self.interfaceOrientation) || 
(self.interfaceOrientation == UIDeviceOrientationUnknown) ) 


for (UIView *view in @[imageView, 
titleLabel, artistLabel, button] ) 


CENTER VIEW H(self.view, view) ; 

} 

CONSTRAIN VIEWS (self.view, @"V:|-80- [imageView] -30-\ 
[titleLabel (>=0) ] - [artistLabel]-15- [button] - (>=0)-|", 
bindings) ; 

} 

else 

{ 
// Center image view on left 
CENTER_VIEW V(self.view, imageView) ; 


// Lay out remaining views 


CONSTRAIN(self.view, imageView, @"H: |- [imageView]") ; 
CONSTRAIN(self.view, titleLabel, G"H:[titleLabel]-15-]|"); 
CONSTRAIN(self.view, artistLabel, @"H: [artistLabel]-15-|"); 
CONSTRAIN(self.view, button, @"H: [button] -15-|"); 
CONSTRAIN VIEWS(self.view, Q"V:|-(»20)-[titleLabel(»20)]^ 

- [artistLabel]-15- [button] -|", bindings); 


// Make sure titleLabel doesn't overlap 
CONSTRAIN VIEWS (self.view, 
@"H: [imageView] - (>=0)-[titleLabel]", bindings); 


// Catch rotation changes 

- (void)willAnimateRotationToInterfaceOrientation: 
(UIInterfaceOrientation)toInterfaceOrientation 
duration: (NSTimeInterval)duration 


[super willAnimateRotationToInterfaceOrientation: 
toInterfaceOrientation duration:duration]; 
[self updateViewControllerConstraints]; 


5.17 调试 约束 规则 


用 代码 向 程序 中 添加 约束 规则 时 ， 最 常 出现 的 问题 就 是 布局 有 上 由 义 和 布局 无 法 满足 。 我 们 需要 花 大 量 时 间 来 查看 Xcode 的 调试 控制 人 台 ， 而 且 会 遇 到 很 多 以 Unable 
to simultaneously satisfy constraints (无 法 同时 满足 约束 规则 ) 开头 的 信息 。 


iOS 在 运行 程序 时 会 尽量 告诉 开 友 者 哪些 约束 规则 无 法 满足 、 哪 些 约束 规则 必须 放弃 。 通 常 它 会 列 出 多 条 规则 ， 而 开发 者 可 以 检查 这 些 规 则 ， 以 确定 问题 所 在 。 这 


种 信息 一 般 会 像 下 面 这 样 : 


Probably at least one of the constraints in the following list is one you don't 
want. Try this: (1) look at each constraint and try to figure out which you don't 
expect; (2) find the code that added the unwanted constraint or constraints and 
fix it. (Note: If you're seeing NSAutoresizingMaskLayoutConstraints that you don't 
understand, refer to the documentation for the UIView property 
translatesAutoresizingMaskIntoConstraints) 
( 

"«NSAutoresizingMaskLayoutConstraint:0x6e5bc90 h=-&- v--&- 
UILayoutContainerView:0x6e540f0.height == UIWindow:0x6e528a0.height>", 

"«NSAutoresizingMaskLayoutConstraint:0x6e5a5e0 h=-&- v=-&- 
UINavigationTransitionView:0x6e55650.height == 
UILayoutContainerView:0x6e540f0.height»", 

"<NSAutoresizingMaskLayoutConstraint:0x6e592f0 h=-&- v=-&- 
UIViewControllerWrapperView:0x6bb90d0.height == 
UINavigationTransitionView:0x6e55650.height - 64>", 


"<NSAutoresizingMaskLayoutConstraint:0x6e57b90 h=-&- v=-&- 
UIView:0x6baef20.height == UIViewControllerWrapperView:0x6bb90d0.height»", 
"«NSAutoresizingMaskLayoutConstraint:0x6e5cd40 h---- v---- 
V: [UIWindow:0x66528a0(480)]»", 
"«NSAutoresizingMaskLayoutConstraint:0x6bbe890 h=--& v=--& 
UILabel:0x6bb3730.midY ==>", 
"«NSLayoutConstraint:0x6bb8cc0 UILabel:0x6bb3730.centerY == 
UIView:0x6baef20.centerY»" 
| 


假如 碰 到 了 这 种 消息 ， 则 可 能 说 明 某 个 视图 的 translatesAutoresizingMasklnto-Constraints 没 有 关闭 。 和 若是 看 到 其 中 有 
NSAutoresizingMaskLayoutConstraint， 而 且 它 还 和 待 排版 的 某 个 控件 (比方 说 本 例 中 的 UlLabel) 有 关 ， 则 问题 很 有 可 能 出 现在 这 个 地 方 。 在 上 面 这 段 消 息 中 ， 笔 
者 把 有 问题 的 那 两 条 规则 加 粗 了 。 


还 有 些 情况 ， 可 能 是 两 条 必须 满足 的 规则 之 间 友 生 了 冲突 ， 也 融 是 说 ， 两 者 所 摘 述 的 布局 方式 互相 矛 导 了 。 从 上 面 这 段 消 息 可 以 看 出 ， 同 一 个 视图 既 要 居中 对 
齐 ， 又 要 左 对 齐 。 为 了 解决 这 一 矛盾 ， 布 局 系统 必须 在 二 者 之 间 做 出 选择 。 它 决定 把 “在 Y 轴 方向 居中 ”这 一 需求 舍弃 掉 ， 而 将 视图 的 顶端 与 上 级 视图 的 顶端 相 对 齐 : 
Will attempt to recover by breaking constraint 


«NSLayoutConstraint:0x6e94250 UILabel:0x6b90e00.centerY == 
UIView:0x6b8ca50.centerY» 


分 析 这 些 与 约束 规则 相关 的 调试 信息 是 件 非常 麻烦 的 事 ， 不 过 只 要 掌握 了 某 些 技巧 ， 还 是 可 以 避 开 一 些 问题 的 。 首 先 ， 在 用 代码 编写 约束 规则 的 时 候 一 次 不 要 写 
太 多 ， 这 样 束 可 以 及 时 发 现 有 错误 的 地 方 。 其 次 ， 可 以 考虑 使 用 程序 清单 5-1 中 的 宏 ， 我 们 在 下 一 节 里 束 会 给 出 这 些 实 。 不 要 在 代码 里 写 入 太 多 “与 上 级 视图 对 
齐 ” 或 “将 尺寸 设 为 nxm” 之 类 的 规则 ， 这 样 会 令 源 文件 变 得 很 乱 。 最 后 要 注意 ， 如 果 没 有 遇 到 必须 用 代码 来 设置 约束 规则 的 情况 ， 那 么 可 以 考虑 通过 1B 所 提供 的 工 
具 来 设计 程序 的 布局 ， 这 样 会 更 容易 些 。 


5.18 ”解决 方案 : 描述 约束 规则 
在 编写 与 调试 约束 规则 的 时 候 ， 你 也 许 会 觉得 ， 如 果 能 把 任意 的 NSLayout-Constraint 对 象 转换 成 一 段 容 易 读 懂 的 描述 信息 ， 那 就 方便 多 了 。 解 决 方案 5-6 可 以 构 
建 出 这 样 一 种 字符 串 ， 用 来 精确 地 描述 出 约束 规则 ， 其 内 容 如 下 所 示 : 
(1000) [UILabel: 6bb32a0].right<=[self].right 
(750) [self].width== ([self].height*1.778) 
(750) [UlLabel: 6bb32a0].leading== ([UlLabel: 6ed2e70].trailing+ 60.000) 


这 条 解决 方案 会 把 NSLayoutConstraint 实 例 以 文本 形式 表示 出 来 。 它 会 从 该 规则 所 涉 视图 的 角度 来 完成 这 件 事 (因此 其 中 也 会 包括 对 视图 本 身 及 其 上 级 视图 的 引 
a 


用 ， 另 外 还 包括 以 [类 名 : 内 存 地 址 ] 这 种 形式 所 列 出 来 的 特定 子 视图 ) 。 


请 注意 ， 并 非 每 条 约束 规则 都 包含 两 个 视图 。 某 些 约束 规则 可 能 只 会 引用 视图 本 身 (比如 上 述 第 二 个 例子 就 是 这 样 ， 它 把 自己 的 宽度 设 为 其 高 度 的 倍数 ) 。 在 这 
些 情况 下 ，item2 属 性 总 是 nil。 


解决 方案 5-6 RIRAN 
@implementation UIView (ConstraintHelper) 


// Return a string that describes an attribute 
- (NSString *)nameForLayoutAttribute: (NSLayoutAttribute)anAttribute 


| 


switch (anAttribute) 

{ 
case NSLayoutAttributeLeft: return @"left"; 
case NSLayoutAttributeRight: return @"right"; 
case NSLayoutAttributeTop: return @"top"; 
case NSLayoutAttributeBottom: return @"bottom"; 
case NSLayoutAttributeLeading: return @"leading"; 
case NSLayoutAttributeTrailing: return G"trailing"; 
case NSLayoutAttributeWidth: return G"width"; 
case NSLayoutAttributeHeight: return @"height"; 
case NSLayoutAttributeCenterX: return @"centerx"; 
case NSLayoutAttributeCenterY: return @"centery"; 
case NSLayoutAttributeBaseline: return @"baseline"; 
case NSLayoutAttributeNotAnAttribute: return @"not-an-attribute"; 
default: return G"unknown-attribute"; 


// Return a name that describes a layout relation 
- (NSString *)nameForLayoutRelation: (NSLayoutRelation)aRelation 


{ 


Switch (aRelation) 
case NSLayoutRelationLessThanOrEqual: return @"<="; 
case NSLayoutRelationEqual: return @"=="; 
case NSLayoutRelationGreaterThanOrEqual: return @">="; 
default: return @"unknown-relation"; 


// Describe a view in its own context 
- (NSString *)nameForItem: (id) anItem 


| 


if (!anItem) return @"nil"; 


if (anItem == self) return G"[self]"; 
if (anItem == self.superview) return @" [superview]"; 
return [NSString stringWithFormat:@" [%@:%d]", [anItem class], (int) anItem]; 


// Transform the constraint into a string representation 


- 


{ 


(NSString *)constraintRepresentation: (NSLayoutConstraint *)aConstraint 


NSString *iteml [self nameForItem:aConstraint.firstItem] ; 


NSString *item2 = [self nameForItem:aConstraint.secondItem]; 
NSString *relation - 

[self nameForLayoutRelation:aConstraint.relation]; 
NSString *attrl = 


[Self nameForLayoutAttribute:aConstraint.firstAttribute] ; 
NSString *attr2 = 


[self nameForLayoutAttribute:aConstraint.secondAttribute] ; 


NSString *result; 


if (!aConstraint.secondItem) 


result = [NSString stringWithFormat:@"(%4.0f) %*@.%@ $9 $0.3f", 
aConstraint.priority, iteml, attri, 
relation, aConstraint.constant]; 


} 


else if (aConstraint.multiplier -- 1.0f) 
{ 
if (aConstraint.constant == 0.0f) 
result = [NSString stringWithFormat:@"(%4.0f) $0.90 $9 %@.%@", 
aConstraint.priority, iteml, attrl, 
relation, item2, attr2]; 
else 
result - [NSString stringWithFormat: 
Q"($4.0f) %@.%@ $9 ($9.59 + $0.3f)", 
aConstraint.priority, iteml, attrl, relation, 
item2, attr2, aConstraint.constant]; 


) 


else 
( 
1f (aConstraint.constant ss 0.0£f) 
result = [NSString stringWithFormat: 
Q"($4.0f) $09.90 $9 ($9.59 * $0.3f)", 
aConstraint.priority, itemi, attri, relation, 
item2, attr2, aConstraint.multiplier]; 
else 
result - [NSString stringWithFormat: 
Q"($4.0f) $0.50 $090 ((%@.%@ * $0.3f) + $0.3f)", 
aConstraint.priority, itemi; attri» relation, 
item2, attr2, aConstraint.multiplier, 
aConstraint.constant]; 


return result; 


(void)showConstraints 


NSString *viewName - [NSString stringWithFormat: 
@"[%@:%d]", [self class], (int) self]; 

NSLog(G"View $9 has $d constraints", 
viewName, self.constraints.count); 

for (NSLayoutConstraint *constraint in self.constraints) 
NSLog(@"%@", [self constraintRepresentation:constraint]); 


priBtfi'in"): 


@end 


5.19 ”用 安 来 创建 约束 规则 


用 约束 规则 来 排 布控 件 的 位 置 是 相当 可 靠 的 。 不 过 ， 融 其 本 身 来 说 ， 它 们 非常 繁 琐 而 且 特 别 几 长 。 开 友 者 要 一 次 又 一 次 地 去 编写 很 难 读 人 的 方法 调用 语句 。 


约束 规则 调试 起 来 也 特别 麻烦 。 一 个 简单 的 拼写 错误 融会 耗费 很 多 时 间 ， 而 且 许多 应 用 程序 所 使 用 的 约束 规则 都 是 一 样 的 。 如 果 可 以 预先 定义 一 些 安 ， 那 么 融 能 
把 排 布 视 图 所 用 的 代码 写 得 更 易 读 懂 且 更 加 可 靠 。 假 如 要 把 某 视 图 与 另外 一 个 视图 居中 对 齐 ， 那 么 直接 使 用 名 为 CENTER_VIEW 的 宏 束 好 ， 而 不 用 每 次 都 编写 约束 规则 
并 调试 它们 。 


创建 好 程序 清单 5-1 中 的 这 些 磊 之后， 我们 束 可 以 把 工作 重心 从 编写 精确 的 约束 规则 定义 转移 为 令 每 个 视图 的 约束 规则 都 协调 且 完 备 。 在 排 布 视图 的 时 候 ， 开 友 者 
经 常 需要 关注 这 两 件 事情 。 


St 


程序 清单 -1 列 出 了 一 套 比 较 丰 富 的 安定 义 。 笔 者 已 经 对 其 进行 了 测试 ， 并 在 本 书 很 多 解决 方案 里 面 都 使 用 了 它们 。 这 些 安 以 一 种 相当 简单 的 方式 来 产生 约束 规 
则 。 请 注意 ， 它 们 并 不 把 创建 出 来 的 NSLayoutConstraint 对 象 返 回 给 调用 者 ， 而 是 将 这 些 约束 规则 添加 到 适当 的 视图 里 。 如 果 需 要 获取 这 些 新 创建 好 的 约束 规则 ， 以 
便 稍 后 移 除 ， 那 么 可 以 上 自己 添加 一 些 能 返回 相关 约束 规则 的 安 ， 或 采用 解决 方案 5-1 中 的 功能 来 搜寻 并 移 除 NSLayoutConstraint。 


由 于 篇 幅 所 限 ， 程 序 清单 5-1 中 没有 包含 另外 一 套 守 ， 也 就 是 那 种 可 以 接受 常量 并 创建 出 约束 规则 的 宏 ， 有 了 时候 它 们 用 起 来 也 很 方便 。 比 方 说 ， 在 将 某 视 图 同上 级 
视图 对 齐 的 时 候 ， 那 种 安 葡 显得 特别 有 用 。 读 者 应 该 很 容易 融 能 写 出 这 种 安 ， 并 将 其 添加 到 程序 库 里 。 在 编写 创建 约束 规则 的 安 时 ， 我 们 需要 在 复杂 硫 和 灵活 度 之 间 
做 出 权衡 ， 并 按照 需求 进行 调整 。 

假如 不 喜欢 安 这 种 形式 ， 那 么 也 可 以 改 为 编写 函数 库 或 是 针对 UIView 类 来 创建 与 约束 规则 有 关 的 category。 你 应 该 选择 一 种 最 符合 目 己 代 码 风格 或 布局 需求 的 方 
式 ， 然 后 逐步 构建 并 完善 这 个 工具 库 。 


程序 清单 5-1 ”用 安 来 创建 约束 规则 


// Prepare Constraint Compliance 
#define PREPCONSTRAINTS (VIEW) \ 
[VIEW setTranslatesAutoresizingMaskIntoConstraints:NO] 


// Add a visual format constraint 
#define CONSTRAIN(PARENT, VIEW, FORMAT) \ 

[PARENT addConstraints: [NSLayoutConstraint \ 
constraintsWithVisualFormat: (FORMAT) options:0 metrics:nil \ 
views:NSDictionaryOfVariableBindings (VIEW)]] 

#define CONSTRAIN VIEWS(PARENT, FORMAT, BINDINGS) \ 

[PARENT addConstraints: [NSLayoutConstraint \ 
constraintsWithVisualFormat: (FORMAT) options:0 metrics:nil \ 
views:BINDINGS]] 


// Stretch across axes 
define STRETCH VIEW H(PARENT, VIEW) N 
CONSTRAIN(PARENT, VIEW, @"H:| ["#VIEW" (>=0)] |") 
#define STRETCH VIEW V(PARENT, VIEW) \ 
CONSTRAIN (PARENT, VIEW, @"V:| ["#VIEW" (>=0)] |") 
#define STRETCH VIEW(PARENT, VIEW) X 
{STRETCH VIEW H(PARENT, VIEW); STRETCH VIEW V(PARENT, VIEW) ;} 


// Center along axes 
#define CENTER VIEW H(PARENT, VIEW) \ 

[PARENT addConstraint:[NSLayoutConstraint \ 
constraintWithItem:VIEW attribute: NSLayoutAttributeCenterX \ 
relatedBy:NSLayoutRelationEqual \ 
toItem:PARENT attribute:NSLayoutAttributeCenterX \ 
multiplier:1.0f constant:0.0f]] 

define CENTER VIEW V(PARENT, VIEW) \ 

[PARENT addConstraint: [NSLayoutConstraint \ 
constraintWithItem:VIEW attribute: NSLayoutAttributeCenterY \ 
relatedBy:NSLayoutRelationEqual \ 
toItem: PARENT attribute:NSLayoutAttributeCenterY \ 
multiplier:1.0f constant:0.0f]] 

"define CENTER VIEW(PARENT, VIEW) ^ 
(CENTER VIEW H(PARENT, VIEW); CENTER VIEW V(PARENT, VIEW) ; } 


// Align to parent 
define ALIGN VIEW LEFT(PARENT, VIEW) \ 

[PARENT addConstraint: [NSLayoutConstraint \ 
constraintWithItem:VIEW attribute: NSLayoutAttributeLeft \ 
relatedBy:NSLayoutRelationEqual ^ 
toItem:PARENT attribute:NSLayoutAttributeLeft V 
multiplier:1.0f constant:0.0f]] 

#define ALIGN VIEW RIGHT(PARENT, VIEW) 

[PARENT addConstraint: [NSLayoutConstraint ^ 
constraintWithItem:VIEW attribute: NSLayoutAttributeRight V 
relatedBy:NSLayoutRelationEqual \ 


toItem:PARENT attribute:NSLayoutAttributeRight ^ 
multiplier:1.0f constant:0.0f]] 
#define ALIGN VIEW TOP(PARENT, VIEW) 

[PARENT addConstraint: [NSLayoutConstraint \ 
constraintWithItem:VIEW attribute: NSLayoutAttributeTop \ 
relatedBy:NSLayoutRelationEqual ^ 
toItem:PARENT attribute:NSLayoutAttributeTop ^ 
multiplier:1.0f constant:0.0£]] 

Hdefine ALIGN VIEW BOTTOM(PARENT, VIEW) x 

[PARENT addConstraint: [NSLayoutConstraint \ 
constraintWithItem:VIEW attribute: NSLayoutAttributeBottom \ 
relatedBy:NSLayoutRelationEqual \ 
toItem:PARENT attribute:NSLayoutAttributeBottom \ 
multiplier:1.0f constant:0.0f]] 


// Set Size 
#define CONSTRAIN WIDTH(VIEW, WIDTH) \ 

[VIEW addConstraint: [NSLayoutConstraint constraintWithItem:VIEW \ 
attribute:NSLayoutAttributeWidth \ 
relatedBy:NSLayoutRelationEqual toItem:nil \ 
attribute:NSLayoutAttributeNotAnAttribute \ 
multiplier:1.0f constant:WIDTH] J; 

#define CONSTRAIN HEIGHT(VIEW, HEIGHT) \ 

[VIEW addConstraint: [NSLayoutConstraint constraintWithItem:VIEW VN 
attribute:NSLayoutAttributeHeight \ 
relatedBy:NSLayoutRelationEqual toItem:nil \ 
attribute:NSLayoutAttributeNotAnAttribute \ 
multiplier:1.0f constant:HEIGHT]]; 


#define CONSTRAIN SIZE(VIEW, HEIGHT, WIDTH) ^ 
(CONSTRAIN WIDTH (VIEW, WIDTH); CONSTRAIN HEIGHT (VIEW, HEIGHT) ; } 


// Set Aspect 
#define CONSTRAIN ASPECT(VIEW, ASPECT) \ 

[VIEW addConstraint: [NSLayoutConstraint \ 
constraintWithItem:VIEW attribute:NSLayoutAttributeWidth V 
relatedBy:NSLayoutRelationEqual \ 
toItem:VIEW attribute:NSLayoutAttributeHeight \ 
multiplier: (ASPECT) constant:0.0f] ] 


// Item ordering 
#define CONSTRAIN ORDER H(PARENT, VIEW1, VIEW2) V 
[PARENT addConstraints: [NSLayoutConstraint \ 
constraintsWithVisualFormat: (@"H: ["#VIEW1"] ->=0- ["#VIEW2"]") \ 
options:0 metrics:nil \ 
views:NSDictionaryOfVariableBindings (VIEW1, VIEW2)]] 
#define CONSTRAIN ORDER V(PARENT, VIEW1, VIEW2) \ 

[PARENT addConstraints: [NSLayoutConstraint \ 
constraintsWithVisualFormat: (@"V: ["#VIEW1"] ->=0- ["#VIEW2"] ") 
options:0 metrics:nil 
views :NSDictionaryOfVariableBindings(VIEW1, VIEW2)]] 


5.20 小结 


本 章 介绍 了 iOSs 的 Auto Layout 特 性 。 在 继续 学 习 下 一 章 之 前 ， 先 回顾 以 下 内 容 : 


. 原来 我 们 可 能 要 从 struts and springs 以 及 尺寸 的 灵活 变化 等 角度 来 考虑 视图 布局 ， 但 现在 苹果 公司 推出 了 Auto Layout 系 统 ， 它 能 够 提供 更 好 的 控制 手段 、 更 强大 的 
功能 以 及 更 灵活 的 工具 。 


- IB 本 身 就 有 一 套 出 色 的 布局 工具 。 但 是 ， 用 代码 来 实现 基于 约束 规则 的 界面 也 是 相当 可 行 并 易于 使 用 的 。 无 论 是 用 IB 还 是 用 程序 码 来 指定 约束 规则 ， 布 局 系统 
都 能 非常 精准 地 控制 视图 。 


.采用 约束 规则 来 指定 视图 布局 有 个 很 大 的 好 处 ， 就 是 不 用 再 针对 每 一 种 分 辨 率 去 设计 一 套 界面 了 。 虽 说 平板 电脑 的 操作 方式 与 iPhone 系列 的 手机 可 能 会 大 不 相 


同 ， 即 使 同样 是 手机 ， 其 视窗 大 小 和 屏幕 大 小 也 不 一 样 ， 而 有 了 这 套 新 工具 之 后 ， 我 们 就 可 以 设计 出 一 套 能 够 自动 适应 这 些 手机 的 界面 来 了 。 这 些 约束 规则 虽然 看 上 
去 很 简单 ， 但 是 其 背后 却 有 着 非常 灵活 而 且 强大 的 地 方 。 


C 在 设计 界面 的 过 程 中 ， 可 以 把 阴影 等 视 党 装饰 物 考 虑 进来 。 无 论 给 框架 添加 多 少 个 辅助 视图 ， 我 们 总 能 通过 对 齐 和 珑 形 来 确保 用 户 界 面 的 布局 是 正确 的 。 


:可视化 的 格式 字符 串 适 合用 来 设计 通用 的 视图 布局 ， 而 视图 之 间 的 关系 则 适合 用 来 指定 具体 的 细节 。 这 两 种 方式 都 非常 重要 ， 在 设计 界面 的 时 候 都 不 应 忽视 。 


第 6 草 文本 输入 


有 些 人 可 能 认为 触摸 设备 上 面 的 文本 输入 没什么 大 不 了 的 ， 因 为 用 尸 已 经 可 以 通过 入 单 的 手势 来 表达 非常 多 的 信息 了 。 不 过 ， 文 本 输入 仍然 是 个 非常 关键 的 功 
能 ， 尤 其 是 当 用 户 从 办 公 室 或 家 中 拿 痢 手机 出 门 操作 时 ， 融 显得 更 为 重要 了 。 很 多 情况 下 ， 用 户 都 需要 输入 并 阅读 屏幕 上 的 文字 。 用 户 可 以 通过 输入 文本 来 登录 账 
号 、 查 看 并 回复 电子 邮件 、 输 入 URL 并 浏 兄 网 页 等 。 苹 果 公 司 的 键盘 有 非常 智能 的 预测 能 力 ， 这 使 得 输入 文本 的 过 程 简 单 而 流畅 。 相 关 的 类 和 框架 也 为 开发 者 提供 了 强 
大 的 手段 ， 用 以 展示 并 操作 程序 中 的 文本 。 


iOS 7 可 以 说 成 是 一 次 与 文本 有 关 的 更 新 。 苹 果 公 司 去 掉 了 很 多 复杂 的 图 案 、 用 户 界 面 装 饰物 (U1 chrome) 以 及 阴影 效果 ， 而 把 注意 力 放 在 了 内 容 上 面 。 在 很 多 
情况 下 ， 这 个 内 容 指 的 就 是 文本 。iOS 7 对 文本 布局 和 泻 染 引擎 做 了 有 史 以 来 最 为 显著 的 一 次 更 新 ， 它 与 新 系统 的 设计 重点 以 及 新 的 Text Kit 技 术 一 起 ， 展 示 出 文本 在 
iOS 生 态 圈 中 的 重要 地 位 。 


Text Kit 为 文本 系统 的 展示 与 输入 等 方面 市 来 了 重大 改变 。 以 前 若 想 调整 字 | 间 距 及 行 间距 等 特性 ， 必 须 深入 Core Text 的 底层 细节 才 行 ， 而 现在 ， 我 们 则 可 以 用 
Text Kit 来 完全 控制 文本 的 泻 染 。UIKit 的 文本 及 文本 输入 控件 都 构建 在 Text Kit 上 面 ， 而 Text Kit 又 构建 在 Core Text FA. 


因 受 范围 所 限 ， 本 书 不 会 完整 地 讲述 由 Text Kit 所 提供 的 功能 ， 不 过 ， 这 些 功能 很 强大 而 且 很 灵活 ， 并 且 非 常 受 开 友 者 欢迎 ， 所 以 ， 还 是 值得 去 研究 一 下 的 。 


本 章 要 介绍 的 各 条 解决 方案 能 够 解决 与 文本 有 天 的 许多 问题 。 你 将 学 到 挎 样 控制 键盘 、 和 号 样 使 屏幕 上 的 控件 具备 文本 输入 能 力 、 如 何 扫 摘 文 本 、 格 式 化 文本 及 编 
辑 文本 。 开 友 者 在 实现 文本 输入 功能 时 会 经 单 遇 到 此 类 问题 ， 而 这 一 章 所 提供 的 解决 方案 可 以 非常 方便 地 解决 它们 。 


6.1 解决 方案 : faRUITextFieldAyess 


对 于 小 设备 及 UITextField 控 件 来 说 ， 有 个 常见 的 问题 束 是 “如 何在 用 户 输 入 完 之 后 把 键盘 关 掉 ”。1iOS 系 统 并 没有 内 置 这 样 一 种 方式 来 自动 侦 测 用 户 是 否 已 经 输 
入 完毕 并 做 出 响应 。 不 过 ， 当 用 户 编辑 完 UITextField 的 内 容 之 后 ， 按 理 说 确实 应 该 把 键盘 天 挤 才 对 。iPad 提 供 了 天 闭 键 盘 的 按钮 ， 但 iPhone 和 iPod touch 则 没有 。 


雷 好 我 们 只 需 稍微 编写 一 些 代码 ， 即 可 在 用 户 编 辑 完 文本 框 之 后 做 出 响应 了 ， 这 种 解决 方案 不 受 平台 限制 。 具 体 做 法 是 提供 Done 按 钮 供用 尸 点 击 ， 然 后 令 文本 框 
放弃 第 一 响应 者 的 身份 。 正 如 解决 方案 6-1 所 示 ， 只 要 放 和 并 了 第 一 响应 者 的 身份 ， 键 盘 残 不 会 出 现在 屏幕 里 了 。 实 现 本 方式 时 ， 有 几 个 关键 事项 要 注意 : 


- 把 Return 键 的 类 型 设 为 UIReturnKeyDone， 以 便 将 文本 由 Return 改 为 Done。 我 们 可 以 在 Interface Builder (IB) 的 Attributes Inspector 里 面 设置 ， 也 可 以 对 文本 
框 的 teturnKeyType 属 性 赋值 。 把 Retutn 键 的 文本 改 为 Done， 可 以 使 用 户 明白 : 在 编辑 完 之 后 ， 只 需 按 下 这 个 键 ， 就 能 结束 编辑 。 如 果 不 这 么 做 的 话 ， 那 么 除非 用 户 曾 在 
非 移 动 平台 的 操作 系统 (nonmobile system) 里 以 类 似 方 式 操作 过 ， 否 则 很 难 知 道 如 何 结束 编辑 状态 。 图 6-1 演 示 了 带 有 Done 键 的 键盘 。 
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图 6-1 ”把 Return 键 的 名 称 设 为 Done (如 左 侧 截 图 所 示 ) ， 可 以 令 用 户 明白 如 何 结束 对 文本 框 的 编辑 。 我 们 可 以 用 代码 或 [B 的 Attributes Inspectot 来 调整 与 文本 框 有 关 的 
Return 键 ， 并 定制 文本 框 的 样 狐 及 行为 


: 令 视 图 控制 器 成 为 文本 框 的 delegate。 你 可 以 用 代码 把 文本 框 的 delegate 属 性 设 为 视图 控制 器 ， 也 可 以 在 IB 里 面 右 击 文本 框 ， 并 进行 配置 。 请 确认 视图 控制 器 已 


经 遵循 并 实现 了 UITextFieldDelegate 协 议 。 


- 实现 textFieldShouldReturn: 万 法 。 无 论 Return 键 叫 什 么 名 字 ， 该 方法 都 会 把 用 户 对 这 个 按键 的 触摸 捕获 下 来 。 我 们 在 该 方法 里 调用 resignFirstResponder， 以 便 
把 键 前 隐藏 起 来 ， 直 到 用 户 下 次 点 击 UITextField 或 UITextView 的 时 候 ， 键 盘 才 会 再 度 出 现 。 


Qs 当 用 户 按 下 Return 键 时 ， 除 了 可 以 在 textFieldShouldReturn: 方法 里 隐藏 键盘 ， 还 可 以 于 该 方法 中 执行 其 他 操作 。 


开 友 者 必须 在 代码 中 处 理 好 上 述 三 个 问题 ， 才 能 为 UITextField 实 例 创建 出 平滑 的 交互 过 程 。 


6.1.1 阻止 系统 把 键盘 隐藏 起 来 


我 们 既 可 以 把 键盘 隐藏 起 来 ， 也 可 以 通过 代码 阻止 这 种 行为 。 如 果 当 前 的 响应 者 并 不 支持 文本 ， 那 么 视图 控制 器 可 以 强 令 键盘 留 在 屏幕 上 。 覆 写 
disablesAutomaticKeyboard-Dismissa| 方 法 即 可 实现 此 功能 。 该 方法 所 返回 的 布尔 值 表 示 程 序 是 否 允 许 系统 将 键盘 隐藏 起 来 。 


6.1.2 UITextlnputTraits 协 议 中 的 属性 


文本 框 (UITextField) 实现 了 UITextlnputTraits 协 议 。 该 协议 提供 了 八 项 属性 ， 我 们 可 以 通过 设置 这 些 属性 ， 来 定义 文本 框 处 理 文 本 输入 的 方式 : 


- autocapitalizationType 该 属性 定义 了 文本 的 自动 大 写 (autocapitalization) 风格 。 可 选 的 样式 有 匈 首 大 写 (sentence capitalization) . 39 E K5 (word capitali- 
zation) 、 全 部 大 写 (all caps) 以 及 不 大 写 (no capitalization) 。 在 输入 用 户 名 和 密码 的 时 候 ， 不 要 使 用 自动 大 写 功 能 。 而 在 输入 专 有 名 称 及 街道 地 址 时 ， 则 可 将 自动 大 


写 风 格 设 为 单词 首 字母 大 写 (word capitalization) o 


该 属性 用 来 决定 文本 框 是 否 开 启 1OS 的 自动 修正 (autocorrect) 功能 。 假 如 启用 这 个 属性 (也 就 是 将 其 值 设 为 UITextAutocorrection- 


: autocorrectionType 


TypeYes) ， 那 么 iDS 就 会 建议 用 别 的 词 来 代替 用 户 所 输入 的 词 。 大 多 数 开 发 者 在 设计 输入 用 户 名 和 密码 的 文本 框 时 ， 都 会 把 自动 修正 功能 关闭 ， 这 样 一 来 ，iOS 就 不 会 


无 意 间 把 myFacebookAccount 这 种 本 来 正确 的 账号 名 替换 成 myofacial count 了。 


- spellCheckingType 该 属性 决定 了 iOS 系 统 是 否 会 在 用 户 输入 文本 时 进行 拼写 检查 。 将 其 设 为 UITextSpellCheckingTypeYes， 即 可 局 用 它 ， 而 把 它 设 为 
UITextSpellCheckingTypeNo， 则 可 以 禁用 它 。 拼 写 检 查 与 自动 修正 不 同 ， 自 动 修正 会 在 用 户 输入 的 过 程 中 直接 替换 文本 ， 而 拼写 检查 则 会 在 文本 输入 界面 中 检测 用 户 可 


能 拼 错 的 词 ， 并 将 其 用 下 划 线 标 出 来 ， 以 此 提示 用 户 这 些 词 可 以 换 成 正确 的 词 。 如 果 开 启 了 自动 修正 功能 ， 那 么 系统 也 会 默认 启用 拼写 检查 。 
: keyboardAppearance 一 一 我 们 可 以 通过 该 属性 在 两 种 键盘 显示 风格 之 间 切 换 : 一 种 是 浅 色 风格 (默认) ， 另 一 种 是 深 色 风格 。 


keyboardType 一 一 当 用 户 操 作文 本 框 或 文本 视图 时 ， 这 个 属性 决定 了 键盘 的 类 型 。iOS 提 供 了 十 几 个 选项 ， 这 些 类 型 包括 : 标准 ASCII、 数 字 与 标点 、 输 入 PIN 
的 数字 键盘 (0 至 9) 、 输 入 电话 号 码 的 键盘 (0 至 9、#、*) 、 小 数 输入 键盘 (0 至 9、.) 、 为 输入 URL 而 优化 的 键盘 (会 凸显 .、/ 及 .com 键 ) 、 为 电子 邮件 而 优化 的 键 
X (会 凸显 @ 和 . 键 ) 以 及 为 Twittet 而 优化 的 键盘 (A X (a) A HE) é 


每 种 键盘 都 排 布 了 不 同 的 按键 ， 它 们 各 有 优 缺 点 。 比 方 说， 电子 邮件 专用 的 键盘 融 很 适合 用 来 输入 电子 邮箱 地 址 。 它 里 面包 含 了 @ 符 号 ， 也 能 够 输入 其 他 文本 。 
而 Twitter 专 用 的 键盘 则 把 # 键 (hashtag， 话 题 标 签 ) 和 @ 键 〈 用 户 ID 标识 竺 ) 摆 在 了 显著 位 置 。 


- enablesReturnKeyAutomatically 一 一 当 文 本 框 或 文本 视图 中 没有 文本 时 ， 该 属性 用 来 决定 系统 是 否 会 禁用 Retutn 键 。 如 果 将 该 属性 设 为 YES， 那 么 只 有 当 用 户 


输入 了 至 少 一 个 字符 之 后 ， 系 统 才 会 自动 启用 Return 键 。 


returnKeyType 一 一 用 来 指定 键盘 上 Return 键 里 的 文本 。 你 可 以 选择 默认 值 (Return) ， 也 可 以 选择 Go、Google、Join、Next、Route、Seatch、Send、Yahoo、 


Done 及 Emergency Call 等 。 你 应 该 根据 用 户 输入 完 之 后 所 要 执行 的 操作 来 设置 该 属性 。 


该 属性 用 来 开启 文本 遮掩 功 能 ， 以 实现 更 安全 的 文本 输入 。 启 用 了 此 属性 之 后 ， 用 户 只 能 看 到 最 后 输入 的 那个 字符 ， 而 其 余 字 符 都 将 显示 


- secureTextEntry 


为 圆 点 。 如 果 某 个 文本 框 是 用 来 输入 窗 码 的 ， 那 么 应 该 开启 此 功能 。 


6.1.3 ”文本 框 的 其 他 属性 


除了 UlTextinputTraits 协 议 里 面 定 义 的 那些 标准 属性 之 外 ， 文 本 框 还 提供 了 一 些 属性 用 以 控制 其 样 狐 。 下 面 列 出 几 个 开发 者 应 该 知晓 的 属性 : 


` 占 位 文本 一 一 图 6-2 演 示 了 带 有 占 位 文本 (placeholder text) 的 文本 框 。 当 文本 框 里 没有 内 容 的 时 候 ， 系 统 会 把 这 些 浅 灰色 文本 显示 出 来 ， 它 能 够 提示 用 户 这 个 文 


本 框 里 应 该 输入 什么 内 容 。 开 发 者 可 以 通过 这 种 占 位 文本 来 提示 用 户 在 文本 框 中 输入 用 户 名 或 电子 邮箱 地 址 等 内 容 ， 如 图 6-2 所 示 。 


Account 


图 6-2 ” 当 文 本 框 里 没有 内 容 的 时 候 ， 就 会 以 浅 灰 色 把 占 位 文本 显示 出 来 。 用 户 在 文本 框 里 输入 的 内 容 会 盖 住 这 些 文 本 。 你 可 以 通过 IB 的 Attributes Inspectot 来 配置 文本 
框 ， 也 可 以 编辑 UITextField 对 象 的 placeholdet 属 性 


C 边框 样式 开发 者 可 以 通过 borderStyle 属 性 来 控制 文本 周转 的 边线 风格 。 可 以 选择 简单 线条 、Bezel 以 及 圆 角 矩形 (如 图 6-2 所 示 ) 。 最 好 是 用 IB 来 调整 这 个 风 
格 ， 因 为 我 们 可 以 通过 IB 的 Attributes Inspector 在 不 同 的 风格 之 间 切 换 。 


` 清除 按钮 一 一 文本 输入 区 域 的 右 侧 可 以 有 个 X 字 样 的 清除 按钮 。 通 过 cleafrButtonMode 属 性 ， 可 以 指定 该 按钮 是 否 出 现 以 及 何 时 出 现 。UITextFieldView- 
ModeAlways T% Æ H1 HL UlTextFieldViewModeNever# T # A HH 3L... UITextFieldViewWhileEditing E zi 4E 28 HH BY OL, UITextField-ViewModeUnlessEditing 7i P FE 


用 户 不 编辑 文本 的 时 候 出 现 。 开 发 者 应 该 尽量 使 用 户 能 够 最 大 限度 地 操控 应 用 程序 才 对 。 


解决 方案 6-1 用 Done 键 来 关闭 文本 框 的 键盘 


// Dismiss the keyboard when the user taps Done 
(BOOL)textFieldShouldReturn: (UITextField *)textField 


[textField resignFirstResponder]; 
return YES; 


- (void)viewDidLoad 
[super viewDidLoad] ; 


// Update all text fields, including those defined in IB, 
// setting delegate, return key type, and other useful traits 
for (UIView *view in self.view.subviews) 


| 


if ([view isKindOfClass: [UITextField class]l) 


{ 


UITextField *aTextField = (UITextField *)view; 
aTextField.delegate = self; 


aTextField.returnKeyType - UIReturnKeyDone; 
aTextField.clearButtonMode - 
UITextFieldViewModeWhileEditing; 


aTextField.borderStyle - UITextBorderStyleRoundedRect; 

aTextField.contentVerticalAlignment - 
UIControlContentVerticalAlignmentCenter; 

aTextField.autocorrectionType - 
UITextAutocorrectionTypeNo; 


aTextField.font - 
[UIFont fontWithName:@"Futura" size:12.0f]; 
aTextField.placeholder = @"Placeholder"; 


获取 解决 方案 代码 


访问 https://github.com/erica/iOS-7-Cookbook 网 页 ， 并 打开 “C06Text Views” 文 件 夹 ， 即 可 找到 与 本 章 中 的 解决 方案 相对 应 的 完整 范例 项 目 。 


6.2 解决 万 案 : 把 市 有 目 定 义 辅助 宙 图 的 键盘 隐藏 起 来 


开 友 者 可 以 通过 目 定 义 的 辅助 视图 (custom accessory view) 来 为 屏幕 上 的 键盘 添加 一 些 额外 的 内 容 。 常 见 的 用 法 包括 添加 自 定义 的 按钮 、 添 加 其 他 可 用 来 选取 
文本 字体 及 文本 颜色 的 控件 ， 另 外 也 可 以 实现 一 些 文本 间 的 导航 方式 。 解 决 方案 6-2 添 加 了 两 个 按钮 ， 一 个 用 来 清除 已 经 输入 的 文本 ， 另 一 个 用 来 隐藏 键盘 。 图 6-3 演 
示 了 审 有 这 些 附加 组 件 的 键盘 。 


Clear 
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图 6-3 ”通过 inputAccessotyView 属 性 ， 可 以 在 标准 的 iDS 键 盘 上 面 添加 自 定 义 的 视图 元 件 。 在 本 例 中 ， 我 们 给 iPhone 和 iPadq 的 键盘 上 面 添加 了 两 个 按钮 


每 个 附属 视图 都 会 与 文本 框 或 文本 视图 这 样 的 Responder 相 关联 (这 个 Responder 继 承 自 UIResponder 类 ) 。 设 置 视图 的 inputAccessoryView 属 性 即 可 为 其 添加 
辅助 视图 。 解 决 方案 6-2 把 一 个 简单 的 工具 栏 用 作 辅 助 视图 ， 这 样 的 话 ， 只 需 编写 极 少 的 代码 ， 就 能 实现 一 些 附加 功能 。 


在 解决 万 案 6-1 中 ， 用 户 可 以 通过 Done 键 来 隐藏 文本 框 的 键盘 (所 谓 文 本 框 ， 是 所 单行 的 文本 输入 控件 ) ， 而 本 例 也 为 用 尸 提供 了 相同 的 功能 ， 使 其 能 够 通过 工 
具 栏 上 的 Done 按 钮 来 关闭 文本 视图 的 键盘 (所谓 文本 视图 ， 是 指 包含 多 行文 字 并 且 可 以 滚动 的 文本 编辑 视图 ) 。 两 者 的 区 别 是 : 本 例 中 ， 用 户 依然 可 以 通过 键盘 上 的 
Return 键 在 文本 中 插入 回 车 符 ， 以 便 给 文字 分 段 。 


Qi; 本 书 的 一 位 技术 评审 说 他 从 来 都 记 不 住 哪个 是 文本 视图 ， 哪 个 是 文本 框 。 对 于 这 件 事 ， 笔 者 回复 说 : “A viewis two; afieldissealed." . BBR, 
文本 视图 可 以 包含 多 行 〈 两 行 或 两 行 以 上 ) 文本 ， 而 文本 框 只 是 个 单行 的 文本 输入 控件 ， 其 文字 周围 画 有 某 种 风格 的 边框 。 


iOS 开 发 者 Phil Mills 说 了 个 更 有 趣 的 口诀 : “Take my text fieldhttp:/ /www.hzcourse.com/resoutce/readBook? 


path= /openresources/teach, ebook /uncompressed/15137/OEBPS/Text/..please." 。 看 到 这 多 话 ， 我 们 就 会 联想 到 ， 文 本 框 (Text Field) 只 能 显示 一 行文 字 。 


解决 方案 6-2 的 Done 按 钮 会 在 其 回调 方法 中 放弃 文本 视图 的 第 一 响应 者 身份 。 由 于 iPad 键 盘 会 自动 显示 出 一 个 用 于 隐藏 键盘 的 按钮 ， 所 以 iPad 用 户 是 用 不 到 这 个 
Done 按 钮 的 ， 不 过 放 在 这 里 也 没什么 坏处 。 如 果 既 要 编写 通用 的 程序 ， 又 要 在 iPad 上 面 隐藏 Done 按 钮 ， 那 么 就 请 根据 当前 的 用 户 界 面 风 格 (user interface idiom) 
来 进行 判断 。 下 面 这 个 宏 提 供 了 一 种 简便 的 判断 方式 ， 可 以 检测 出 程序 是 否 运 行 在 iPad 上 面 : 


Hdefine IS IPAD (UI USER INTERFACE IDIOM() == UIUserInterfaceIdiomPad) 


请 注意 ， 苹 果 公司 将 来 可 能 会 推出 一 些 规 格 不 同 的 新 iOs 设 备 ， 有 的 也 许 屏幕 会 比较 大 ， 有 的 也 许 会 比较 小 ， 所 以 开 友 者 必须 要 针对 那些 设备 编写 相应 的 代码 才 
行 ， 在 使 用 nputAccessoryView 这 种 占据 较 多 屏幕 空间 的 功能 时 ， 更 是 如 此 。 由 于 目前 只 有 两 套 界 面 风格 (iPhone 和 iPad) ， 所 以 需要 处 理 的 情况 不 是 很 多 ， 然 而 开 
发 者 还 是 应 该 在 将 来 可 能 帮 生 变化 的 地 方 添加 一 些 注释 。 


解决 方案 6-2 ”向 键盘 中 添加 目 定义 按钮 


@implementation TestBedViewController 


| 


UITextView *textView; 
UIToolbar *toolBar; 


// Remove text from text view 
- (void)clearText 


| 


[textView setText:Q""]; 


// Dismiss keyboard by resigning first responder 


(void)leaveKeyboardMode 


[textView resignFirstResponder]; 


(UIToolbar *)accessoryView 


// Create toolbar with Clear and Done 
toolBar = [[UIToolbar alloc] initWithFrame: 

CGRectMake(0.0f, 0.0£f, self.view.frame.size.width, 44.0f)]; 
toolBar.tintColor = [UIColor darkGrayColor] ; 


// Set up the items as Clear - flexspace - Done 

NSMutableArray *items = [NSMutableArray array]; 

[items addObject:BARBUTTON(G"Clear", Gselector(clearText))]; 

[items addObject:SYSBARBUTTON (UIBarButtonSystemItemFlexibleSpace, nil)]; 
[items addObject:BARBUTTON (G"Done", Gselector(leaveKeyboardMode))]; 
toolBar.items - items; 


return toolBar; 


- (void)loadView 


self.view - [[UIView alloc] init]; 
self.view.backgroundColor - [UIColor whiteColor]; 


// Create text view and add the custom accessory view 
textView - [[UITextView alloc] initWithFrame:self.view.bounds]; 
textView.font = [UIFont fontWithName:@"Georgia" 

size:(IS IPAD) ? 24.0f : 14.0f]; 
textView.inputAccessoryView - [self accessoryView]; 


// Use constraints to fill application bounds 
[self.view addSubview:textView]; 
PREPCONSTRAINTS (textView); 

STRETCH VIEW(self.view, textView); } 


@end 


6.3 解决 方案 : 根据 键盘 来 调整 文本 视图 


iOS 的 键盘 


图 6-4 键盘 占据 了 iOS 设 备 很 大 一 部 分 屏幕 空间 。 当 屏幕 上 有 键盘 的 时 候 ， 如 果 我 们 既 不 调整 视图 的 尺寸 ， 也 不 将 其 上 移 ， 那 么 键盘 就 会 把 某 些 本 来 应 该 


Poranna per ipsum. Donec convallis tincidunt urna. 


Suspendisse et orci et arcu porttitor pellentesque. Sed lacus nunc, fermentum 
vel, vehicula in, imperdiet eget, urna. Nam consectetuer euismod nunc. Nulla 
dignissim posuere nulla. Integer iaculis lacinia massa. Nullam sapien augue, 
condimentum vel, venenatis 1d, rhoncus pellentesque, sapien. Donec sed 
ipsum ultrices turpis consectetuer imperdiet. Duis et ipsum ac nisl laoreet 
commodo. Mauris eu est. Suspendisse id turpis quis orci euismod consequat. 
Donec tellus mi, luctus sit amet, ultrices a, convallis eu, lorem. Proin faucibus 
convallis elit. Maecenas rhoncus arcu at arcu. Proin libero. Proin adipiscing. In 
quis lorem vitae elit consectetuer pretium. Nullam ligula urna, adipiscing nec, 
iaculis ut, elementum non, turpis. Fusce pulvinar. 


THIS TEXT IS AT THE BOTTOM 


convallis elit. Maecenas rhoncus arcu at arcu. Proin libero. Proin adipiscing. In 
quis lorem vitae elit consectetuer pretium. Nullam ligula urna, adipiscing nec, 
iaculis ut, elementum non, turpis. Fusce pulvinar. 


THIS TEXT IS AT THE BOTTOM 


给 遮 住 。 在 最 后 一 张 截图 里 ， 由 于 文本 视图 一 直 会 延伸 至 屏幕 底 端 ， 所 以 键盘 会 把 屏幕 下 方 的 一 部 分 文本 挡住 


是 相当 大 的 ， 它 占据 了 屏幕 上 面 很 大 一 部 分 空间 。 瞧 于 此 ， 我 们 应 该 在 屏幕 上 面 有 键盘 的 时 候 调 整 文本 框 及 文本 视图 ， 不 要 令 键盘 把 它们 给 遮 住 。 图 6- 


4 演示 了 这 个 问题 


能 看 见 的 文本 


| Suspendisse et orci et arcu porttitor pellentesque. Sed lacus nunc, fermentum 
vel, vehicula in, imperdiet eget, urna. Nam consectetuer euismod nunc. Nulla 
dignissim posuere nulla. Integer 1aculis lacinia massa. Nullam sapien augue, 

I candimentuim vel venenatis 1d rhoncus nellentesmie sanien Donec sed 


Q W | H T Y H 


return 


顶端 截图 演示 了 文本 视图 在 具备 第 一 响应 者 身份 之 前 的 样子 。 中 间 截 图 演示 了 用 户 所 期 望 的 效果 ， 也 束 是 说 ， 即 便 屏 幕 上 面 有 和 键盘， 用户 也 应 该 能 够 看 到 并 触摸 
整个 文本 视图 。 而 底部 规 图 则 是 既 不 调整 视图 尺寸 ， 又 不 移动 视图 位 置 时 的 样子 。 这 时 ， 屏 幕 上 约 有 三 分 之 一 的 文本 内 容 无 法 看 到 。 用 户 看 不 到 最 后 几 行文 本 ， 而 且 
也 无 法 编辑 它们 。 键 盘 把 屏幕 上 最 后 几 段 文 本 兰 住 了 ， 这 使 得 用 户 不 能 触摸 到 那 一 个 区 域 。 

我 们 可 以 调整 文本 视图 的 大 小 ， 或 移动 其 位 置 ， 使 键盘 不 会 把 那么 多 文本 挡住 。 当 屏幕 上 面 显 示 出 键盘 的 时 候 ， 如 果 用 户 还 要 继续 操作 这 个 视图 ， 那 么 融 应 该 把 
视图 与 键盘 分 开 ， 不 要 使 两 者 重 堵 。 为 了 实现 这 一 目标 ， 应 用 程序 必须 订阅 与 键盘 有 关 的 通知 。 

iOS 提 供 了 许多 种 通知 ， 它 们 都 是 由 标准 的 NSNotificationCenter 来 散发 的 : 

: UIKeyboardWillShow Notification 

: UlKeyboardDidShowNotification 

: UIKeyboardWillChangeFrameNotification 


: UIKeyboardWillHideNotification 


: UIKeyboardDidHideNotification 
把 对 象 注册 为 observer (观察 者 ) ， 即 可 监听 这 些 通知 。 下 面 这 段 代 码 能 够 监听 will hide 通 知 ， 并 使 用 target-selector (目标 -选择 子 ) 式 的 回调 来 接收 这 种 通 
Xl: 
[[NSNotificationCenter defaultCenter] addObserver:self 


selector:Gselector(keyboardWillHide:) 
name:UIKeyboardWillHideNotification object:nil]; 


你 也 可 以 通过 基于 块 的 APl 来 订阅 并 处 理 相关 的 通知 。 


有 两 种 通知 经 常 需要 监听 ， 就 是 will show 和 will hide， 前 者 会 发 生 在 屏幕 马上 就 要 把 键盘 显示 出 来 的 时 候 ， 而 后 者 则 发 生 在 键盘 即将 从 屏幕 中 移 走 的 时 候 。 每 个 
通知 都 提供 了 名 为 userlnfo 的 字典 ， 开 发 者 可 以 用 UIKeyboardFrameEndUserlnfoKey 作 键 来 查询 键盘 最 后 的 尺寸 及 位 置 (frame) 。 你 不 能 直接 访问 键盘 本 身 。 


获取 到 键盘 的 frame 之 后 ， 融 可 以 根据 屏幕 上 是 否 会 显示 键盘 这 一 因素 来 调整 文本 视图 。 解 决 方案 6-3 癌 程序 里 添加 了 KeyboardspacingView 对 象 ， 它 会 适时 地 


调整 其 约束 规则 ， 以 适应 键盘 的 高 度 。 把 这 个 KeyboardSspacingView 添 加 到 界面 底部 之 后 ， 它 会 监听 并 处 理 与 键盘 有 天 的 事件 ， 并 据 此 调整 自身 的 尺寸 。 我 们 通过 约 
整 其 大 小 : 


束 规 则 在 文本 视图 与 这 个 KeyboardSpacingView 之 间 建 立 天 系 ， 这 样 的 话 ， 当 KeyboardSpacingView 的 尺寸 有 变化 时 ， 文 本 视图 也 会 调整 其 


// Create a spacer 
KeyboardSpacingView *spacer - 


[KeyboardSpacingView installToView:self.view]; 


// Place the spacer under the text view 
CONSTRAIN(self.view, @"V:|[textView] [spacer] |", 
NSDictionaryOfVariableBindings(textView, spacer) ) ; 


这 样 实现 出 来 的 文本 视图 能 够 完全 适应 不 同 的 硬件 ， 并 且 还 能 根据 inputAccessory View 来 调整 自己 的 大 小 。 


解决 方案 6-3 ”创建 专用 的 KeyboardSpacingView 对 象 


@implementation KeyboardSpacingView 


| 


NSLayoutConstraint *heightConstraint; 


// Listen for keyboard 
- (void)establishNotificationHandlers 
{ 
// Listen for keyboard appearance 
[[NSNotificationCenter defaultCenter] 
addObserverForName:UIKeyboardWillShowNotification 
object:nil queue: [NSOperationQueue mainQueue] 
usingBlock:^(NSNotification *note) 


// Fetch keyboard frame 

NSDictionary *userInfo - note.userInfo; 

NSTimeInterval duration - 
[userInfo[UIKeyboardAnimationDurationUserInfoKey] 


doubleValue]; 
CGRect keyboardEndFrame - [self.superview 
convertRect: [userInfo [UIKeyboardFrameEndUserInfoKey] 
CGRectValue] 


fromView: self.window]; 


// Adjust to window 

CGRect windowFrame - [self.superview 
convertRect:self.window.frame fromView:self.window]; 

CGFloat heightOffset - (windowFrame.size.height - 
keyboardEndFrame.origin.y) - 
self.superview.frame.origin.y; 


// Update and animate height constraint 
heightConstraint.constant - heightOffset; 
[UIView animateWithDuration:duration animations: ~{ 


[self.superview layoutIfNeeded]; 
Hs 
2E 


// Listen for keyboard exit 

[[NSNotificationCenter defaultCenter] 
addObserverForName:UIKeyboardWillHideNotification object:nil 
queue: [NSOperationQueue mainQueue] 


usingBlock:^(NSNotification *note) 


// Reset to zero 

NSDictionary *userInfo - note.userInfo; 

NSTimeInterval duration - 
[userInfo[UIKeyboardAnimationDurationUserInfoKey] 

doubleValue]; 

heightConstraint.constant - 0; 

[UIView animateWithDuration:duration animations:^[( 
[self.superview layoutIfNeeded]; 


}]; 
AF 


// Stretch sides and bottom of spacer to superview 
- (void)layoutView 


{ 


self.translatesAutoresizingMaskIntoConstraints = NO; 

if (!self.superview) return; 

for (NSString *constraintString in @[@"H:|[view]|[", @"V: [view] |"]) 
NSArray *constraints = [NSLayoutConstraint 


constraintsWithVisualFormat:constraintString options:0 
metrics:nil views:@{@"view":self}]; 
[self.superview addConstraints:constraints] ; 
} 
heightConstraint = [NSLayoutConstraint constraintWithItem:self 
attribute:NSLayoutAttributeHeight 
relatedBy:NSLayoutRelationEqual toltem:nil 


attribute:NSLayoutAttributeNotAnAttribute multiplier:1.0f 
constant:0.0f]; 


[self addConstraint:heightConstraint]; 


+ (instancetype)installToView: (UIView *)parent 

{ 
if (iparent) return nil; 
KeyboardSpacingView *view = [[self alloc] init]; 
[parent addSubview:view] ; 


[view layoutView] ; 
[view establishNotificationHandlers] ; 


return view; 


@end 


6.4 解决 方案 : 创建 目 定 义 的 输入 视图 


当 文 本 视图 或 文本 框 成 为 第 一 响应 者 之 后 ， 我 们 可 以 用 自 定义 的 输入 视图 (custom input view) 把 系统 所 提供 的 键盘 替换 成 自己 所 设计 的 视图 。 这 种 自 定义 的 输 
入 视图 不 仅 可 以 添加 到 文本 视图 中 ， 而 且 还 可 以 前 加 到 非 文 本 视图 (nontext view) [中 。 解 决 方案 6-4 关 注 前 一 种 情况 。 


如 果 我 们 设置 了 响应 者 的 inputView 属 性 ， 那 么 赋 给 该 属性 的 那个 视图 就 会 取代 系统 键盘 。 有 种 非常 简单 的 办 法 可 以 演示 这 一 特性 ， 束 是 创建 纯色 视图 ， 并 将 其 赋 
给 inputView 属 性 。 下 面 这 段 代码 创建 了 两 个 文本 框 ， 然 后 又 创建 了 背景 为 紫色 的 UIView 实 例 ， 并 把 该 实例 赋 给 第 二 个 文本 框 的 inputView 属 性 : 


// Create two standard text fields 

UITextField *textFieldl = [[UITextField alloc] init]; 
textFieldl.borderStyle - UITextBorderStyleRoundedRect; 
[self.view addSubview:textFieldl]; 

PREPCONSTRAINTS (textFieldl); 

CONSTRAIN SIZE(textFieldl, 30, 200); 
CENTER VIEW H(self.view, textFieldl) ; 

ALIGN VIEW TOP CONSTANT(self.view, textFieldl, 40); 


UITextField *textField2 - [[UITextField alloc] init]; 
textField2.borderStyle = UITextBorderStyleRoundedRect ; 
[self.view addSubview:textField2] ; 
PREPCONSTRAINTS (text Field2) ; 

CONSTRAIN SIZE(textField2, 30, 200); 

CENTER VIEW H(self.view, textField2); 

ALIGN VIEW TOP CONSTANT(self.view, textField2, 80); 


// Create a purple view to be used as the input view 

UIView *purpleView - [[UIView alloc] initWithFrame: 
CGRectMake(0.0f, 0.0f, self.view.frame.size.width, 120.0f)]; 

purpleView.backgroundColor - COOKBOOK PURPLE COLOR; 


// Assign the input view 
textField2.inputView - purpleView; 


图 6-5 演 示 了 上 述 代 码 的 运行 效果 。 当 第 一 个 文本 框 成 为 第 一 响应 者 之 后 ， 系 统 所 提供 的 键盘 就 会 显示 在 屏幕 上 ;而 当 用 户 选 中 第 二 个 文本 框 时 ， 屏 幕 上 则 会 出 现 
那个 紫色 的 视图 。 
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图 6-5 ”这 两 个 文本 框 的 其 他 方面 都 相同 ， 只 是 在 成 为 了 第 一 响应 者 之 后 会 产生 不 同 的 效果 。 顶 部 那个 文本 框 会 显示 标准 的 键盘 (如 左 侧 截 图 所 示 ) ， 而 底部 的 文本 框 


则 会 显示 出 我 们 赋 给 inputView 属 性 的 那个 纯色 视图 ， 而 不 会 弹出 系统 键盘 (如 右 侧 堆 图 所 示 ) 


由 于 紫色 视图 里 面 没有 提供 互动 式 控件 ， 所 以 我 们 没 办 法 再 继续 操作 下 去 了 。 不 能 输入 文本 ， 也 不 能 把 这 个 “键盘 ”隐藏 起 来 。 我 们 只 能 欣赏 一 下 这 种 可 以 显示 


自 定义 视图 的 功能 。 现 在 请 重新 选中 顶部 那个 文本 框 ， 切 换 到 标准 键盘 。 


在 绝 大 多 数 的 日 剃 编码 工作 中 ， 我 们 都 不 会 采用 上 自 定 义 的 输入 视图 来 实现 文本 输入 。 对 于 某 些 类 型 的 程序 来 说， 输入 视图 确实 扮演 着 重要 的 角色 ， 比 方 说 ,设计 
游戏 时 ， 就 非常 需要 用 到 这 种 视图 。 尽 管 如 此 ， 人 在 实现 文本 输入 功能 的 时 候 ， 我 们 还 是 很 少 使 用 它 。 一 方面 是 因为 我 们 可 以 改 用 inputAccessoryView 属 性 来 做 ， 那 样 
能 保留 系统 内 置 的 键盘 ， 同 时 又 能 给 键盘 上 面 添加 额外 的 按键 。 而 另 一 方面 则 在 于 ， 系 统 键盘 本 身 已 经 提供 了 输入 数字 和 小 数 (IOS 4.1 系 统 加 入 了 这 一 选项 ) 专用 


的 键 位 组 合 。 在 早期 的 iOs 版 本 中 ， 开 上 友 者 之 所 以 要 实现 自 定 义 的 输入 视图 ， 很 大 程度 上 是 因为 想 设计 这 种 专用 的 键盘 ， 而 现在 则 不 需要 这 样 做 了 。 


那么 ， 在 处 理 文 本 的 时 候 ， 应 该 于 什么 场合 使 用 和 目 定 义 的 输入 视图 呢 ? 它 适 用 于 那 种 开 友 者 想 要 完全 控制 用 户 体 验 的 场合 。 在 这 种 情况 下 ， 我 们 要 伦 时 间 和 精力 
来 设计 自己 的 键盘 ， 而 且 需 要 把 各 种 平台 及 屏幕 方向 都 考虑 进来 ， 另 外 还 要 注意 Shift 键 的 问题 。 我 们 可 以 创建 一 种 能 够 完全 自 定义 而 且 能 够 更 换 皮 肤 的 输入 控件 来 取 
代 系统 键盘 ， 以 便 与 自己 独 有 的 设计 风格 相 搭 配 。 这 在 多 个 层面 上 都 需要 很 大 的 工作 量 才 能 做 到 |。 

解决 方案 6-4 提 供 了 一 个 极为 简单 的 例子 ， 用 来 演示 目 定 义 的 文本 输入 视图 。 这 个 视图 不 是 用 来 输入 单个 字符 的 ， 而 是 提供 了 两 个 按钮 : 一 个 可 以 输入 Hello， 另 
一 个 可 以 输入 World (参见 图 6-6) 。 用 户 按 下 某 个 按钮 后 ， 对 应 的 单词 就 会 添加 到 相关 的 文本 视图 里 面 。 
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Done 


Hello World Hello World Hello World 
Hello Hello Hello | 


图 6-6 ”将 这 个 文本 视图 的 inputView 设 为 自 定义 的 键盘 ， 使 得 用 户 可 以 输入 Hello 与 World 这 两 个 词 


这 种 键盘 只 有 这 个 功能 
创建 这 种 自 定 义 的 文本 输入 视图 时 ， 其 难点 在 于 如 何 把 文本 的 变更 反馈 给 第 一 响应 者 。iOS 没 有 和 直接 提供 这 样 一 种 方式 或 属性 ， 使 得 自 定义 的 输入 视图 可 以 查 出 当 


前 拥有 焦点 的 那个 视图 ， 而 且 它 也 不 能 简单 地 通过 访问 上 级 视图 的 属性 来 确定 此 信息 。 为 了 应 对 这 个 问题 ， 我 们 可 以 针对 UIView 类 实现 一 个 简单 的 扩展 ， 用 以 获取 当 
前 的 第 一 响应 者 : 


@interface UIView (FirstResponderUtility) 
+ (UIView *)currentResponder; 
@end 


@implementation UIView (FirstResponderUtility) 
- (UIView *) findFirstResponder 


| 


if ([self isFirstResponder]) return self; 


for (UIView *view in self.subviews) 


| 


UIView *responder - [view findFirstResponder]; 
if (responder) return responder; 


| 


return nil; 


+ (UIView *)currentResponder 


UIWindow *keyWindow - 
[[UIApplication sharedApplication] keyWindow]; 
return [keyWindow findFirstResponder]; 


} 


@end 


Qs 在 上 面 这 段 代 码 中 ， 笔 者 故意 把 那个 类 方法 取 名 叫 作 cuttentRespondet， 以 免 与 私有 的 API 相 冲突 。 


没有 对 外 公布 的 那个 私有 API 方 法 名 叫 firstResponder。 在 开发 正式 的 软件 产品 (而 不 是 本 书 这 种 范例 程序 ) 时 ， 如 果 要 针对 苹果 公司 的 类 编写 category， 并 在 其 中 添 
加 方法 ， 那 么 请 遵循 一 条 原则 ， 就 是 给 所 有 的 方法 名 都 加 上 前 级 。 这 个 前 级 可 以 是 开发 者 姓名 的 首 字 母 缩写 ， 也 可 以 是 公司 名 称 的 首 字母 缩写 ， 还 可 以 是 菜 种 独特 的 
标识 符 。 这 样 做 可 以 确保 category 中 的 方法 不 会 和 苹果 公司 本 身 的 方法 重 名 。 此 外 ， 还 有 个 更 为 重要 的 原因 ， 就 是 可 以 避免 与 苹果 公司 将 来 可 能 添加 进来 的 方法 相 冲 
突 。 然 而 为 了 令 范例 代码 读 起 来 更 容易 也 更 好 辨认 ， 本 书 没 有 遵循 这 条 建议 。 


解决 方案 6-4 构 建 了 自 定义 的 UIToolbar， 并 将 其 用 作 输 入 视图 ， 这 个 UIToolbar 上 面 有 两 个 选项 ， 分 别 是 Hello 和 World。 用 户 点 击 某 个 按钮 时 ， 它 会 把 对 应 的 文 
本 添加 到 第 一 响应 者 现 有 的 文本 之 中 。 如 果 发 现 responderView 变 量 还 没有 设置 好 ， 就 先 查 到 第 一 响应 者 ， 并 将 其 赋 给 该 变量 。 然 后 ， 它 会 判断 第 一 响应 者 所 属 的 类 
是 不 是 UlTextView。 如 果 是 的 话 ， 就 把 新 的 文本 添加 到 里 面 。 


对 于 输入 视图 (input view) 来 说 ， 下 列 规 律 一 般 是 成 立 的 。 首 先 ， 屏 幕 上 展示 出 来 的 这 个 输入 视图 的 拥有 者 (owner) 总 会 具备 第 一 响应 者 的 身份 。 其 次 ， 该 
拥有 者 是 应 用 程序 的 主 窗口 的 子 视图 。 我 们 可 以 利用 这 两 条 规律 来 改写 代码 ， 但 这 可 能 需要 在 解决 方案 6-4 的 基础 上 再 添加 一 些 错误 检测 代码 ， 尤 其 要 注意 对 


responderView 这 个 实例 变量 的 复 用 。 


解决 方案 6-4 ”创建 自 定义 的 输入 视图 


@interface InputToolbar : UIToolbar 
@end 


@implementation InputToolbar 


| 
| 


- (void)insertString: (NSString *)string 


| 


UIView *responderView; 


if (!responderView || ![responderView isFirstResponder]) 
responderView = [UIView currentResponder]; 
if (!responderView) return; 


if ([responderView isKindOfClass: [UITextView class]]) 
| 
UITextView *textView - (UlTextView *) responderView; 
NSMutableString *text - 
[NSMutableString stringWithString:textView.text]; 
NSRange range - textView.selectedRange; 
[text replaceCharactersInRange:range withString:string]; 
textView.text - text; 
textView.selectedRange - 
NSMakeRange (range.location + string.length, 0); 
| 
else 
NSLog(@"Cannot insert $9 in unknown class type (%@)", 
string, [responderView class]); 


// Perform the two insertions 
- (void)hello: (id)sender { [self insertString:@"Hello "];} 
- (void)world: (id)sender {[self insertString:@"World "];} 


// Initialize the bar buttons on the toolbar 
- (instancetype) initWithFrame: (CGRect) aFrame 


| 


self - [super initWithFrame: aFrame; 


if (self) 
{ 
NSMutableArray *theItems = [NSMutableArray array]; 
[theItems addObject : SYSBARBUTTON ( 
UIBarButtonSystemItemFlexibleSpace, nil)]; 
[theItems addObject : BARBUTTON ( 
@"Hello", Gselector(hello:))]; 
[theItems addObject :SYSBARBUTTON ( 
UIBarButtonSystemItemFlexibleSpace, nil)]; 
[theItems addObject : BARBUTTON ( 
@"World", @selector(world:))]; 
[theItems addObject : SYSBARBUTTON ( 
UIBarButtonSystemItemFlexibleSpace, nil)]; 
self.items = theItems; 


| 


return self; 


| 


@end 


[1] 可 以 理解 为 本 身 不 具备 文本 输入 功能 的 视图 。 一 一 译 者 注 


6.5 ”解决 方案 : 使 视图 具备 文本 输入 功能 


默认 情况 下 ， 只 有 少数 几 个 视图 能 够 输入 文本 ， 不 过 ， 我 们 只 需 编 写 少量 代码 ， 融 可 以 给 几乎 任意 视图 添加 键盘 文 持 了 。 其 天 键 葡 在 于 实现 简单 的 UIKeylnput 协 
议 。 另 外 还 需要 稍微 操作 一 下 第 一 响应 者 ， 这 样 束 可 以 随意 为 视图 添加 文本 输入 功能 


解决 方案 6-5 演 示 了 如 何 把 标准 的 UIToolbar 变 成 一 种 可 以 接受 键盘 输入 的 视图 ， 使 得 用 户 能 够 直接 在 工具 栏 里 输入 文本 ， 其 效果 如 图 6-7 所 示 。 在 用 户 打字 的 时 
候 ， 工 具 栏 里 的 文本 也 会 随 之 更 新 ， 而 且 它 还 能 正确 地 处 理 Delete (删除 ) 键 。 


这 条 解决 方案 需要 用 好 几 个 特性 才能 实现 出 来 。 首 先 ， 工 具 栏 必须 声明 它 自己 遵从 UlKeylinput 协 议 。 遵 从 了 该 协议 ， 束 表明 这 个 视图 可 以 实现 简单 的 文本 输入 功 
能 ， 并 且 在 成 为 第 一 响应 者 之 后 ， 能 够 把 系统 键盘 (或 自 定义 键盘 ) 显示 出 来 。 


其 次 ， 工 具 栏 必须 保留 自身 状态 ,就 是 说 ， 必 须 把 用 户 输 入 的 字符 串 保 存 起 来 。 我 们 可 以 把 字符 串 放 在 一 个 受 保留 而 且 可 变 的 属性 里 ， 这 样 的 话 ， 工 具 栏 就 可 以 
知道 目前 正在 操作 并 且 需 要 显示 给 用 户 看 的 那 段 文本 了 。 


第 三 ， 工 具 栏 必须 成 为 第 一 响应 者 。 可 以 用 两 种 方式 做 到 这 一 点 : 实现 canBecome-FirstResponder 万 法 并 返回 YES; 捕获 触摸 事件 ， 并 判断 工具 栏目 前 是 否 应 该 
具备 第 一 响应 者 这 一 角色 。 我 们 添加 一 个 处 理 程序 来 处 理 用 户 对 工具 栏 的 触摸 ， 并 使 其 成 为 第 一 响应 者 。 


最 后 ， 它 必须 实现 UIKeylnput 协 议 所 规定 的 三 个 方法 : hasText, insertText: 以 及 deleteBackward。 通 过 这 些 方法 的 名 称 ， 我 们 就 能 确切 地 知道 其 功能 。 如 果 
视图 里 面 有 文本 ， 那 么 hasText 方 法 就 应 返回 YES。insertText : 方法 会 在 当前 的 插入 点 添加 文本 (在 本 例 中 ， 插 入 点 总 是 位 于 现 有 文本 的 末端 ) ， 而 deleteBackward 
方法 每 次 会 从 显示 出 来 的 这 段 文本 末尾 删除 一 个 字符 。 
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This text is being typed in from the keyboard 


图 6-7 令 UIToolbar 遵 从 UIKeyInput 协 议 ， 这 样 就 可 以 把 工具 栏 变 成 能 够 接受 文本 输入 的 视图 了 ， 这 种 视图 会 把 输入 用 的 键盘 显示 出 来 ， 而 且 能 够 正确 处 理 “ 删 除 字 


符 ” 这 一 操作 


遵循 UIKeylnput 协 议 、 成 为 第 一 响应 者 、 处 理 与 字符 串 有 天 的 状态 并 处 理 与 输入 有 关 的 回调 方法 一 一 解决 方案 6-5 正 是 通过 这 些 手段 ， 为 基本 的 UIView 对 象 添加 
了 简单 而 稳定 的 文本 输入 功能 。 开 有 友 者 可 以 根据 应 用 程序 的 需求 ， 把 同样 的 文本 输入 功能 添加 到 标签 、 导 舰 栏 、 按 钮 等 其 他 类 里 面 。 


解决 方案 6-5 ”给 非 文本 视图 添加 键盘 输入 功能 


@interface KeyInputToolbar: UIToolbar «UIKeyInput» 
@end 


@implementation KeyInputToolbar 


人 


NSMutableString *string; 


// Is there text available that can be deleted 
- (BOOL) hasText 


| 


if (!string || !string.length) return NO; 


return YES; 


// Reload the toolbar with the string 

- (void)update 

( 
NSMutableArray *theItems = [NSMutableArray array]; 
[theItems addObject:SYSBARBUTTON(UIBarButtonSystemItemFlexibleSpace, nil)]; 
[theItems addObject:BARBUTTON(string, @selector (becomeFirstResponder) )]; 
[theItems addObject:SYSBARBUTTON(UIBarButtonSystemItemFlexibleSpace, nil)]; 


self.items - theItems; 


// Insert new text into the string 

- (void)insertText: (NSString *)text 

{ 
if (!string) string = [NSMutableString string] ; 
[string appendString:text] ; 
[self update] ; 


// Delete one character 
- (void) deleteBackward 
{ 
// Super caution, even if hasText reports YES 
if (!string) 
{ 
string = [NSMutableString string] ; 
return; 


if (!string.length) 
return; 


// Remove a character 
[string deleteCharactersInRange:NSMakeRange(string.length - 1, 1)]; 
[self update] ; 


// When becoming first responder, send out a notification to that effect. 
// Can be used to add a Done button in the navigation bar 
- (BOOL) becomeFirstResponder 
{ 

BOOL result = [Super becomeFirstResponder] ; 

if (result) 

[(NSNotificationCenter defaultCenter] 
postNotification: [NSNotification notificationWithName: 
@"KeyInputToolbarDidBecomeFirstResponder" object:nil]]; 
return result; 


- (BOOL)canBecomeFirstResponder 


| 


return YES; 


- (void)touchesBegan: (NSSet *)touches withEvent: (UIEvent *)event; 


[self becomeFirstResponder]; 


@end 


6.6 解决 方案 : 为 非 文本 视图 添加 自 定义 的 输入 视图 


我 们 可 以 给 文本 视图 及 文本 框 指定 目 定 义 的 输入 视图 ， 不 过 ， 这 种 视图 在 其 他 情况 下 可 能 更 为 有 上 用。 输入 的 内 容 不 一 定 必 须 是 文本 。 实 际 上 ， 只 要 抛 开 系 统 键 
盘 ， 我 们 就 可 以 根据 自己 的 需要 来 设计 自 定 义 的 输入 视图 了 。 


你 可 以 把 这 种 输入 视图 理解 成 与 上 下 文 相关 的 图 形 菜单 ， 只 有 在 特定 的 视图 类 成 为 第 一 响应 者 时 ， 它 才 会 弹出 来 。 比 万 说 ， 操 击 一 个 “战士 ”之 后 ， 屏 幕 上 会 出 
现 几 种 武器 ， 其 中 有 马 、 杖 、 剑 。 用 尸 可 以 在 里 面 选 择 战 士 的 攻击 方式 。 又 比如 有 个 图 形 排版 程序 。 当 用 户 点 击 其 中 的 圆圈 、 正 方形 或 线条 时 ， 屏 幕 上 可 能 会 出 现 调 
色 板 ， 用 尸 可 以 在 其 中 设置 线条 宽度 、 线 条 颜色 以 及 填充 方式 。 只 要 尽情 地 想象 ， 束 能 用 目 定 义 的 输入 视图 设计 出 很 多 东西 来 。 


解决 方案 6-6 演 示 了 如 何 用 目 定义 的 输入 视图 来 影响 非 文本 视图 中 的 内 容 。 它 把 解决 方案 6-4 与 解决 方案 6-5 的 代码 结合 起 来 ， 创 建 了 具备 输入 功能 的 视图 (Bate 
ColorView) ， 该 视图 在 接受 用 户 触 摸 之 后 ， 会 变 为 第 一 响应 者 ， 同 时 ， 它 给 这 个 视图 配置 了 上 自 定 义 的 输入 视图 (也 束 是 InputToolbar) ， 此 视图 能 够 影响 主 视图 的 
显示 效果 。 在 本 例 中 ，ColorView 这 个 基本 的 视图 仪 仅 负 责 演示 颜色 。 而 作为 输入 视图 的 InputToolbar 则 用 来 控制 具体 应 该 显示 何 种 颜色 。 


解决 方案 6-6 ”为 非 文 本 视图 创建 自 定义 的 输入 控制 器 


@interface ColorView : UIView 
Gproperty (strong) UlView *inputView; 
@end 


// Key Input Aware View 
@implementation ColorView 


// UITextInput protocol 

- (BOOL)hasText {return NO; } 

- (void) insertText: (NSString *)text {} 
- (void)deleteBackward {} 


// First responder support 
- (BOOL)canBecomeFirstResponder (return YES;) 
- (void)touchesBegan: (NSSet *) touches 
withEvent: (UIEvent *)event {[self becomeFirstResponder] ; } 


// Initialize with user interaction allowed 
- (instancetype) initWithFrame: (CGRect) aFrame 
{ 
self = [super initWithFrame:aFrame] ; 
if (self) 
{ 
self.backgroundColor = COOKBOOK PURPLE COLOR; 
self.userInteractionEnabled = YES; 


} 


return self; 


j 


@end 


// Color input toolbar 


@interface InputToolbar : UIToolbar «UIInputViewAudioFeedback» 
@end 


@implementation InputToolbar 
- (BOOL) enableInputClicksWhenVisible 


{ 


return YES; 


- (void)updateColor: (UIColor *)aColor 
{ 
[UIView currentResponder] .backgroundColor = aColor; 
[[UIDevice currentDevice] playInputClick] ; 
} 
// Color updates 
- (void) light: (id) sender { 
[self updateColor: [COOKBOOK PURPLE COLOR 
colorWithAlphaComponent :0.33f£]];} 
- (void)medium: (id)sender { 
(self updateColor: [COOKBOOK PURPLE COLOR 
colorWithAlphaComponent:0.66f]];) 
- (void) dark: (id)sender { 
[self updateColor:COOKBOOK PURPLE COLOR] ; } 


// Resign first responder on pressing Done 
- (void) done: (id) sender 
{ 


[[UIView currentResponder] resignFirstResponder] ; 


// Create a toolbar with each option available 


- (instancetype)initWithFrame: (CGRect)aFrame 


{ 
self = [super initWithFrame:aFrame] ; 
if (self) 
| 
NSMutableArray *theItems = [NSMutableArray array]; 
[theItems addObject:BARBUTTON(G"Light", @selector(light:))]; 
[theItems addObject:SYSBARBUTTON( 
UIBarButtonSystemItemFlexibleSpace, nil)]; 
[theItems addObject:BARBUTTON(G"Medium", Gselector (medium:))]; 
[theItems addObject :SYSBARBUTTON ( 
UIBarButtonSystemItemFlexibleSpace, nil)]; 
[theItems addObject:BARBUTTON(G"Dark", Gselector(dark:))]; 
[theItems addObject:SYSBARBUTTON ( 
UIBarButtonSystemItemFlexibleSpace, nil)]; 
[theItems addObject:BARBUTTON(G"Done", Gselector(done:))]; 
self.items - theItems; 
| 
return self; 
| 
@end 


由 于 没有 其 他 方式 能 够 转移 第 一 响应 者 身份 ， 所 以 我 们 在 目 定 义 的 输入 视图 上 面 ， 给 用 户 提供 了 Done 按 钮 ， 使 其 可 以 天 闭 键 盘 ， 从 而 解除 大 ColorView 的 第 一 响 
应 者 身份 。 


添加 按键 首 交 
我 们 可 以 通过 UlDevice 类 来 为 自 定义 的 输入 视图 添加 点 击 按键 的 声音 。play-InputClick 方 法 能 够 播放 标准 的 系统 键盘 敲 击 声 ， 当 用 户 点 击 我 们 自制 的 键盘 时 ， 可 
以 调用 该 方法 来 播放 按键 音效 。 


我 们 令 自 定义 的 输入 视图 遵循 UlInputViewAudioFeedback 协 议 ， 并 添加 名 为 enablelnputClicksWhenVisible 的 委托 方法 ， 令 其 返回 YES。 程 序 是 否 真 的 会 播放 
按键 音效 ， 还 要 看 用 户 在 Settings> Sounds 里 面 所 选 则 的 音频 播放 设置 。 只 有 当 用 户 开 启 了 Keyboard Clicks 时 ， 才 会 在 点 击 键盘 按键 的 时 候 听 到 按键 音 。 假 如 用 户 没 
开启 该 选项 ， 那 么 系统 将 会 忽略 playlnputClick 语 句 。 


6.7 解决 万 案 : 创建 更 好 的 文本 编辑 器 〈 第 一 部 分 ) 


我 们 可 以 给 应 用 程序 里 的 文本 编辑 器 添加 撤销 (Undo) 功能 ， 并 令 其 随时 显示 出 帮助 信息 ， 以 便 将 它 做 得 更 好 一 些 。 这 些 特性 能 够 确保 用 户 在 打 错 字 之 后 可 以 撤 
销 刚才 所 输入 的 内 容 ， 并 使 编辑 器 中 的 文本 恢复 到 原来 的 样子 。 通 过 解决 方案 6-7， 我 们 会 惊讶 地 友 现 这 种 功能 只 需 编 写 一 点 点 代码 就 能 实现 出 来 。 


£NNNZNNN 


文本 视图 本 身 内 置 了 select (选择 ) . cut (S) . copy (复制 ) 与 paste (粘贴 ) 等 操作 。 而 undo manager (撤销 管理 器 ) 则 能 够 理解 这 些 操作 的 含义 ， 而 
且 还 能 够 解读 诸如 Undo Paste (撤销 粘贴 操作 ) . Redo Cut (SHARR) 等 消息 。 知 想 文 持 撤销 功能 ， 视 图 控制 器 只 需 实例 化 一 个 undo manager 即 可 ， 剩 下 
的 事 都 由 系统 内 置 的 对 象 来 完成 。 


解决 方案 6-7 向 键盘 的 辅助 视图 中 添加 了 Undo 和 Redo 按 钮 。 我 们 必须 根据 文本 视图 的 内 容 随时 更 新 这 些 按钮 的 状态 。 为 了 实现 此 目标 ， 我 们 把 视图 控制 器 设 为 广 
本 视图 的 delegate (Bit) ， 并 实现 名 为 textViewDidChange: 的 委托 方法 。 这 样 就 能 根据 文本 内 容 来 启用 或 禁用 按钮 了 。 


这 条 解决 方案 采用 持久 化 存储 形式 来 保存 文本 内 容 ， 以 便 下 次 启动 程序 时 可 以 继续 使 用 。 它 会 在 performArchive 方 法 里 将 文本 存 入 文件 中 。AppDelegate 会 在 程 
序 即将 暂停 之 前 调用 这 个 方法 ， 而 且 还 会 在 文本 视图 每 次 放弃 第 一 响应 者 身份 时 调用 它 ， 以 确保 下 次 打开 应 用 程序 后 ， 能 够 看 到 最 新 的 文本 : 


- (void) applicationWillResignActive: (UIApplication *)application 


| 
| 


[tbvc archiveData]; 


程序 启动 的 时 候 ， 会 读 入 该 文件 里 的 数据 ， 并 在 设置 视图 控制 器 的 时 候 初 始 化 UITextView 实 例 。 


解决 方案 6-7 ”为 文本 视图 添加 撤销 功能 及 持久 化 功能 


#define SYSBARBUTTON(ITEM, SELECTOR) [[UIBarButtonItem alloc] ^ 
initWithBarButtonSystemItem:ITEM target:self action:SELECTOR] 

#define SYSBARBUTTON TARGET(ITEM, TARGET, SELECTOR) \ 
((UIBarButtonItem alloc] initWithBarButtonSystemItem:ITEM WV 
target:TARGET action: SELECTOR] 


// Store data out to file 
- (void) archiveData 
[textView.text writeToFile:DATAPATH atomically:YES 
encoding: NSUTF8StringEncoding error:nil]; 


// Update the undo and redo button states 
- (void) textViewDidChange: (UITextView *)textView 


| 


[self loadAccessoryView]; 


// Choose which items to enable and disable on the toolbar 
- (void) loadAccessoryView 
{ 
NSMutableArray *items = [NSMutableArray array]; 
UIBarButtonItem *spacer = 
SYSBARBUTTON (UIBarButtonSystemItemFixedSpace, nil) ; 
Spacer.width = 40.0f; 


BOOL canUndo = [textView.undoManager canUndo] ; 

UIBarButtonlItem *undoltem = SYSBARBUTTON TARGET ( 
UIBarButtonSystemItemUndo, self, eselector(undo)); 

undoItem.enabled = canUndo; 

[items addObject:undoItem]; 

[items addObject:spacer]; 


BOOL canRedo - [textView.undoManager canRedo]; 

UIBarButtonItem *redoItem = SYSBARBUTTON TARGET ( 
UIBarButtonSystemItemRedo, self, Gselector(redo)); 

redoItem.enabled = canRedo; 

[items addObject:redoItem]; 

[items addObject:spacer]; 


[items addObject:SYSBARBUTTON (UIBarButtonSystemItemFlexibleSpace, 


nil)l; 


[items addObject:BARBUTTON(G"Done", Gselector(leaveKeyboardMode))]; 


toolbar.items - items; 


// Call undo on the undoManager and update toolbar buttons 
- (void)undo 
{ 

[textView.undoManager undo] ; 

[Self loadAccessoryView] ; 


// Call redo on the undoManager and update toolbar buttons 
- (void) redo 
{ 

[textView.undoManager redo]; 

[self loadAccessoryView] ; 


// Return a plain accessory view 
= (UIToolbar *) accessoryView 


{ 


toolbar = [[UIToolbar alloc] 
initWithFrame:CGRectMake(0.0f, 0.0f, 100.0f, 44.0£)]; 

toolbar.tintColor = [UIColor darkGrayColor] ; 

return toolbar; 


(void) loadView 


self.view = [[UIView alloc] init]; 


// Load any existing string 
if ([(NSFileManager defaultManager] fileExistsAtPath:DATAPATH]) 


NSString *string - 
[NSString stringWithContentsOfFile:DATAPATH 
encoding:NSUTF8StringEncoding error:nil]; 


textView.text - string; 


// Subscribe to keyboard frame changes and update layout 

[[NSNotificationCenter defaultCenter] addObserver:self 
selector:Gselector(updateTextViewBounds:) 
name:UIKeyboardDidChangeFrameNotification object:nil] ; 


6.8 解决 万 案 : 创建 更 好 的 文本 编辑 器 〈 第 二 部 分 ) 


MIOS 6 开始 ， 文 本 视图 与 文本 框 都 支持 用 Attributed Text String (市 属性 的 文本 字符 串 ) 来 修饰 文本 了 (也 就 是 说 ， 开 始 支 持 种 有 样式 的 文本 了 ， 而 不 是 仪 仅 支 
寺 纯 文本 ) 。 这 样 的 话 ， 我 们 束 能 创建 字体 、 风 格 和 颜色 各 异 的 文本 视图 和 文本 框 了 。 


在 iOS 7 之 前 ， 要 想 实现 一 些 稍微 复杂 的 样式 ， 融 必须 依赖 Core Text 才 行 。 而 现在 有 了 Text Kit， 它 简化 并 扩展 了 对 文本 样式 的 支持 。 对 于 本 例 这 种 简单 的 文本 编 
辑 器 来 说， 只 需 编写 少量 代码 ， 束 能 令 其 支持 粗 体 、 和 斜体 及 下 划 线 等 基本 样式 。 


6.8.1 启用 Attributed Text 

为 了 处 理 用 户 修改 文本 样式 的 请 求 ， 我 们 必须 改变 文本 视图 的 一 个 标志 ， 令 其 可 以 支持 Attributed Text (Attributed Text 就 是 Styled Text 的 意思 ， 即 有 样式 的 文 
本 ) 。 把 allows-EditingTextAttributes 属 性 设 为 YES 之 后 ， 会 出 现下 面 几 种 情况 : 

` 文本 视图 开始 更 新 它 的 atttibutedText 属 性 。 开 发 者 可 以 通过 该 属性 ， 以 Atttibuted Stting 的 形式 获取 文本 视图 中 的 内 容 。 


C 文本 视图 开始 响应 一 系列 UIRespondet 方 法 ， 当 用 户 要 对 所 选 文本 运用 粗 体 、 斜 体 及 下 划 线 等 效果 时 ， 我 们 就 需要 在 对 应 的 方法 里 做 出 响应 。 下 一 节 将 详细 讲述 
这 些 方 法 。 


` 视图 的 交互 式 用 户 界 面 菜单 开始 显示 新 的 选项 ， 用 户 可 以 通过 这 些 选 项 ， 对 当前 所 选 的 文本 运用 粗 体 、 斜 体 及 下 划 线 等 效果 。 


6.8.2 ”控制 文本 的 样式 
在 iOS 6 中 ，NSObject 提 供 了 一 些 方法 ， 可 用 来 控制 文本 的 许多 特征 。 这 些 方法 是 非 正 式 协议 UIResponderstandardEditActions 的 一 部 分 ， 而 且 是 设计 给 
UlResponder 子 类 使 用 的 。 此 协议 声明 了 iOS 用 户 界面 中 一 些 常用 的 编辑 命令 。 


与 本 例 有 关 的 方法 包括 toggleBoldFace: 、toggleltalics: 及 toggleUnderline: 。 这 三 个 方法 用 于 给 当前 所 选 文本 添加 相关 样式 ， 如 果 这 段 文 本 已 经 运用 了 对 应 
的 样式 ， 那 么 就 会 将 该 样式 移 除 。 


我 们 只 需 命令 responder (在 本 例 中 ， 指 的 是 文本 视图 ) 启用 文本 样式 编辑 功能 ， 束 可 以 支持 这 些 样式 修改 操作 。 相 关 的 文本 视图 或 文本 框 会 处 理 所 有 细节 问题 。 
我 们 要 做 的 ， 融 是 把 这 些 方 法 指定 为 工具 栏 上 相关 按钮 的 动作 。 


解决 方案 6-8 演 示 了 怎样 将 这 些 功能 集成 到 iOS 应 用 程序 里 。 图 6-8 是 由 这 条 解决 方案 所 构建 出 来 的 界面 。 


解决 方案 6-8 增强 版 文本 编辑 器 


// Handy bar button macros 

#define BARBUTTON(TITLE, SELECTOR) [(UIBarButtonItem alloc] ^ 
initWithTitle:TITLE style:UIBarButtonItemStylePlain ^ 
target:self action:SELECTOR] 

#define BARBUTTON TARGET(TARGET, TITLE, SELECTOR) \ 
[[UIBarButtonItem alloc] initWithTitle:TITLE \ 
style:UIBarButtonItemStylePlain target:TARGET action:SELECTOR] 

#define SYSBARBUTTON(ITEM, SELECTOR) [[UIBarButtonItem alloc] \ 
initWithBarButtonSystemItem:ITEM target:self action:SELECTOR] 

#define SYSBARBUTTON TARGET(ITEM, TARGET, SELECTOR) V 
[[UIBarButtonItem alloc] initWithBarButtonSystemItem:ITEM \ 

target:TARGET action:SELECTOR] 


// Choose which items to enable and disable on the toolbar 
- (void)loadAccessoryView 


| 


NSMutableArray *items = [NSMutableArray array] ; 


BOOL canUndo = [textView.undoManager canUndo] ; 

UIBarButtonItem *undoItem - SYSBARBUTTON TARGET( 
UIBarButtonSystemItemUndo, self, Gselector(undo)); 

undoItem.enabled - canUndo; 

[items addObject:undoItem] ; 


BOOL canRedo = [textView.undoManager canRedo] ; 

UIBarButtonItem *redoItem = SYSBARBUTTON TARGET ( 
UIBarButtonSystemItemRedo, self, @selector (redo) ) ; 

redoItem.enabled = canRedo; 

[items addObject:redoItem] ; 


// Add select all 
[items addObject :SYSBARBUTTON (UIBarButtonSystemItemFlexibleSpace, nil)]; 
[items addObject:BARBUTTON TARGET (textView, @"Sel", Gselector(selectAll:))]; 


// Add style buttons 
[items addObject:SYSBARBUTTON (UIBarButtonSystemItemFlexibleSpace, nil)]; 
[items addObject:BARBUTTON TARGET (textView, 
Q"B", @selector(toggleBoldface:))]; 
[items addObject:BARBUTTON TARGET (textView, 
@"I", Gselector(toggleItalics:))]; 


[items addObject:BARBUTTON TARGET (textView, 

@"U", Gselector(toggleUnderline:))]; 
[items addObject:SYSBARBUTTON (UIBarButtonSystemItemFlexibleSpace, nil)]; 
[items addObject:BARBUTTON(G"Done", Gselector(leaveKeyboardMode))]; 


toolbar.items - items; 


6.8.3 可 供 UIResponder 使 用 的 其 他 功能 


请 注意 辅助 工具 栏 上 面 的 Sel 按 钮 ， 该 按钮 位 于 BIU 选 项 左 侧 (B、1、U 分 别 表示 粗 体 (bold) 、 和 斜体 (italic) 、 下 划 线 (underline) ) 。 这 个 sel 按 钮 为 编辑 器 
NI f Select All (选取 全 部 文本 ) 的 功能 ,我们 是 经 由 UIlRespondersStandardEditActions 协 议 来 实现 此 功能 的 。 这 个 协议 包含 了 下 列 与 编辑 操作 有 关 的 万 法 : 


Carrier = 10:53 PM | 


Lorem ipsum dolor bit a 


Cut Copy Paste BJU Define 


ZIXICIV NM & 


flea space return 


datdE'ditActions 协 议定 义 了 常用 的 文本 编辑 命令 ， 开 发 者 可 以 在 自己 设计 的 用 户 界面 里 调用 这 些 命令 。 系 统 菜单 中 会 自动 出 现 BIU 选 项 ， 


而 


键盘 上 方 那个 辅助 视图 (accessory view) 也 为 这 三 个 选项 分 别提 供 了 三 个 按钮 。 用 户 可 以 通过 辅助 视图 里 的 Sel 按 钮 来 选取 全 部 文本 ， 也 可 以 通过 B、I、U 等 按钮 对 文本 
运用 (或 者 从 文本 中 取消 ) 加 粗 、 变 斜体 以 及 加 下 划 线 等 效果 


. 基本 的 编辑 操作 : copy: 、cut: 、delete: 及 paste: 
.与 选取 有 关 的 Select: 及 selectAll: 
- 与 修改 样式 有 关 的 toggleBoldFace: ~ toggleltalics: JtoggleUndetline: 


开发 者 可 以 通过 该 协议 的 makeTextWritingDirectionLeftToRight: Jzmake-TextWritingDirectionRightToLeft: 方法 来 控制 书写 方向 。 


6.9 解决 方案 : 过 滤 用 户 所 答 入 的 文本 


有 时 候 我 们 想 确保 用 尸 只 能 输入 某 个 特定 范围 内 的 字符 。 比 方 说， 开 友 者 可 能 想 创 建 一 种 只 接受 数字 而 不 接受 字母 的 文本 框 。 昌 说 可 以 通过 谓词 将 最 终 的 文本 同 
正则 表达 式 (regular expression) 相 比 较 ， 并 以 此 来 过 滤 数 据 (NSPredicate 类 的 MATCH 操 作 符 支 持 将 正则 表达 式 用 作 其 值 ， 解 决 方案 6-10 将 会 演示 这 一 功能 ) , 
但 还 有 一 种 更 简单 的 办 法 ， 融 是 在 用 户 打 字 时 直接 检查 每 个 新 字符 是 否 处 于 可 以 接受 的 范围 内 。 


当 用 户 输入 字符 的 时 候 ， 我 们 可 通过 UITextField 的 委托 来 捕获 这 些 字 符 ， 并 决定 是 否 应 该 将 其 添加 到 当前 活动 的 文本 框 中 。 有 个 可 选 的 委托 方法 叫 作 textField : 
should-ChangeCharactersInRange: replacementString: ， 如 果 它 返回 YES9， 就 表示 应 该 把 新 输入 的 字符 添加 到 文本 框 中 ， 若 返回 NO， 则 表示 不 允许 把 新 字符 添 
加 进来 。 实 际 上 ， 每 当 用 户 点 击 键盘 时 ， 系 统 就 会 调用 这 个 方法 ， 于 是 ， 我 们 就 可 以 逐次 检查 每 一 个 字符 了 。 但 如 果 用 户 通过 iOS 的 剪贴 板 功能 把 文本 粘贴 到 文本 框 
里 ， 那 么 粘贴 进来 的 文本 可 就 不 一 定 只 包含 一 个 字符 了 。 


解决 方案 6-9 会 在 新 字符 串 里 寻找 不 允许 输入 的 字符 。 如 果 找 到 了 这 种 字符 ， 就 拒绝 用 户 所 输入 的 内 容 ， 并 保持 文本 框 里 原 有 的 文本 不 变 。 假 如 用 户 想 要 粘贴 进来 
的 文本 里 面 既 有 我 们 允许 的 字符， 又 有 不 允许 的 字符 ， 那 么 束 把 整个 文本 全 部 回绝 。 


解决 方案 6-9 ”对 用 户 所 输入 的 文本 进行 过 滤 
#define ALPHA QG"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz " 


@implementation TestBedViewController 

- (BOOL)textField: (UITextField *)aTextField 
shouldChangeCharactersInRange: (NSRange) range 
replacementString: (NSString *)string 


NSMutableCharacterSet *cs = 
[NSMutableCharacterSet 
characterSetWithCharactersInString:@""] ; 


Switch (segmentedControl.selectedSegment Index) 
{ 
case O0: 
[cs addCharactersInString:ALPHA]; 
break; 
case 1: 
[cs formUnionWithCharacterSet: 
[NSCharacterSet decimalDigitCharacterSet]]; 
break; 
case 2: 
[cs formUnionWithCharacterSet: 
[NSCharacterSet decimalDigitCharacterSet]]; 
// permit one decimal only 
if ([textField.text rangeOfString:G"."].location 


-- NSNotFound) 
[cs addCharactersInString:@"."]; 
break; 
case 3: 
[cs addCharactersInString:ALPHA]; 
[cs formUnionWithCharacterSet: 
[NSCharacterSet decimalDigitCharacterSet]]; 
break; 
default: 
break; 


NSString *filtered - 
[[string componentsSeparatedByCharactersInSet: [cs invertedSet] ] 
componentsJoinedByString:@""] ; 
BOOL basicTest = [string isEqualToString: filtered] ; 
return basicTest; 


- (void) segmentChanged: (UISegmentedControl *)seg 
{ 
// Reset text on segment change 
textField.text = or"; 


- (void) loadView 

{ 
self.view = [[UIView alloc] init]; 
self.view.backgroundColor = [UIColor whiteColor] ; 


// Create a testbed text field to work with 
textField = [[UITextField alloc] init]; 
textField.placeholder = @"Enter Text"; 
[self.view addSubview:textField] ; 


PREPCONSTRAINTS (textField) ; 
CONSTRAIN(self.view, textField, @"V:|-30-[textField]"); 
CONSTRAIN(self.view, textField, @"H:|-[textField(>=0)]-|"); 


textField.delegate - self; 

textField.returnKeyType - UIReturnKeyDone; 
textField.clearButtonMode - UITextFieldViewModeAlways; 
textField.borderStyle - UITextBorderStyleRoundedRect; 
textField.autocorrectionType - UITextAutocorrectionTypeNo; 
// Add segmented control with entry options 


segmentedControl - [[UISegmentedControl alloc] initWithItems: 
[@"ABC 123 2.3 A2C" componentsSeparatedByString:@" "]]; 
segmentedControl.selectedSegmentIndex = 0; 


[segmentedControl addTarget:self action:Gselector(segmentChanged:) 
forControlEvents:UIControlEventValueChanged] ; 


self.navigationItem.titleView = segmentedControl; 


| 


@end 


本 条 解决 方案 考虑 了 四 种 情况 : 只 能 输入 字母 、 只 能 输入 数字 、 只 能 输入 数字 和 人 小数点 、 可 混合 输入 字母 及 数字 。 你 可 以 根据 目 己 想 要 接受 的 其 他 字符 集 来 改编 
范例 代码 。 


对 于 第 三 种 过 滤 类 型 ， 也 就 是 只 能 输入 数字 和 小 数 点 的 那 种 类 型 来 说 ， 需 要 使 用 一 点 小 技巧 才能 保证 文本 框 中 只 会 有 一 个 小 数 点 。 如 果 在 相关 的 文本 框 里 已 经 发 
现 了 小 数 点 ， 那 么 把 可 以 接受 的 字符 集 从 “数字 和 小 数 点 ”切换 到 “只 包含 数字 ”。 有 用户 可 以 通过 粘贴 操作 来 绕 过 这 一 限制 。 昌 说 这 种 情况 不 太 可 能 友 生 ， 但 开 皮 者 
仍然 应 该 考虑 到 才 对 。 我 们 通过 覆 写 文本 框 的 canPerformAction: withSender: 方法 来 把 粘贴 操作 从 用 户 可 以 使 用 的 操作 里 排除 掉 。 


下 面 这 段 代 码 使 得 用 户 无 法 向 文本 框 中 粘贴 内 容 。 当 系统 向 该 方法 查询 是 否 可 以 使 用 paste: 操作 时 ， 该 方法 会 返回 NO。 它 还 通过 类 似 的 条 件 判断 语句 来 保证 
Select (选取 ) 和 Select All (全 选 ) 操作 必须 在 文本 框 里 有 内 容 的 时 候 (也 就 是 hasText 为 YES 的 时 候 ) 才能 执行 。 在 用 户 所 选 的 内 容 不 为 空 时 ， 程 序 会 开启 Cut 及 
Copy 操 作 : 


@interface LimitedTextField : UITextField 
@end 
@implementation LimitedTextField 
- (BOOL) canPerformAction: (SEL) action withSender: (id) sender 
| 
UITextRange *range - self.selectedTextRange; 
BOOL hasText - self.text.length » 0; 


if (action == @selector(cut:)) return !range.empty; 
if (action == @selector(copy:)) return !range.empty; 
if (action -- Gselector(select:)) return hasText; 

if (action == @selector(selectAll:)) return hasText; 
if (action == @selector(paste:)) return NO; 


return NO; 


| 


@end 


我 们 要 记 住 一 条 经 验 : 如 果 程 序 的 机 制 有 漏洞 ， 那 么 请 不 要 低 佑 用户 利用 这 一 漏洞 的 能 力 。 


6.10 ”解决 方案 : 检测 文本 模式 


解决 方案 6-9 介 绍 了 如 何 把 用 户 能 够 输入 的 字符 限制 在 我 们 所 允许 的 范围 内 。 有 了 这 个 程序 之 后 ， 只 需 再 前 进一步 ， 束 可 以 学 会 悍 样 检测 出 用 尸 所 输入 的 内 容 是 否 
符合 各 种 文本 模式 (text pattern) 了 。 比 方 说 要 判断 用 户 输 入 的 是 不 是 浮 点 数 ， 我 们 可 以 把 浮 点 数 这 种 模式 描述 为 : 可 选 的 正 负 号 后 面 跟着 整数 部 分 ， 而 整数 部 分 后 
面 可 以 有 一 个 小 数 点 ， 其 后 又 有 小 数 部 分 。 还 可 以 把 整数 部 分 规定 为 可 选 的 ， 只 要 求 有 正 负 号 、 小 数 点 及 小 数 部 分 即 可 。 


除了 简单 的 数值 之 外 ， 还 有 电话 号 码 、 电 子 邮 箱 地 址 、URL 等 事物 ， 而 用 来 限定 这 些 事 物 的 标准 会 特别 复杂 。 苹 果 公 司 已 经 用 内 置 的 NSDataDetector 类 把 其 中 某 
些 标 准 设计 好 了 ， 但 我 们 也 应 该 学 会 如 何 构建 自己 的 标准 。 


6.10.1 ”构建 自己 的 正则 表达 式 
某 些 标 准 化 组 织 友 布 了 对 一 些 事物 的 精准 描述 ， 有 些 好 心 的 开 友 者 便 把 它们 转化 成 了 便于 移植 的 正则 表达 式 。 比 方 说 ， 下 面 这 个 正则 表达 式 可 以 用 来 定义 浮 点 
aN: 
^ [*-1? [0-9] +[\.] ? [0-9] *$ 
这 个 定义 并 不 是 十 分 完美 ,但 在 很 多 场合 下 还 是 相当 好 的 ， 而 且 用 起 来 也 很 灵活 。 它 能 够 接受 一 大 批 浮 点 数 ， 而 且 它 规定 开头 的 正 负 号 是 可 选 的 。 尽 管 这 个 表达 
式 不 能 接受 -.75 这 样 的 数 ， 但 是 它 也 有 个 好 处 ， 就 是 能 把 -. 这 样 的 输入 拦住 ， 笔 者 认为 ， 这 样 的 权衡 方案 是 合理 的 ， 因 为 用 户 在 输入 了 -.75 并 遭 到 拒绝 之 后 ， 


能 想到 上 自己 应 该 输入 的 是 -0.75。 此 外 ， 也 可 以 用 另 一 个 正则 表达 式 把 上 述 表 达 式 无 法 接受 的 那些 合法 浮 点 数 检 测 出 来 。 比 方 说 ， 我 们 想 接 受 那 种 没有 整数 部 分 但 是 有 
小 数 点 ， 而 且 小 数 点 后 面 必须 跟 痢 一 个 或 多 个 数位 的 浮 点 数 : 


“{+-] ?\. [0-9] +$ 


NSpPredicate 实 例 可 以 把 NSstring 文 本 与 正则 表达 式 相 比 较 ， 并 判断 出 用 户 是 不 是 输入 了 有 效 的 浮 点 数 。 比 方 说 : 


NSPredicate *fpPredicate = [NSPredicate predicateWithFormat: 
@"SELF MATCHES '^[«-]? [0-9] « [NV .]? [0-9] *$' "] ; 
BOOL match = [fpPredicate evaluateWithObject:string] ; 


刚才 说 过 ， 要 想 用 正则 表达 式 来 检测 电话 号 码 、 电 子 邮件 地 址 或 其 他 更 为 复杂 的 输入 类 型 是 有 些 困难 的 。 下面 给 出 的 这 个 正则 表达 式 以 最 直接 的 方式 搞 述 了 美国 


电话 号 码 的 格式 : 
“[\(]?([2-9] [0-9] {2}) 001? E-.N. }?([2-9] 0-91 {2}) [-.\. ]2( (0-9) {4})$ 


上 述 正则 表达 式 规定 括号 是 可 选 的 ， 但 我 们 没 办 法 判断 左右 括号 是 否 匹 配 ， 然 而 只 需 再 编写 一 些 简单 的 Objective-C 代 码 ， 即 可 实现 这 一 点 。 这 条 正则 表达 式 能 够 
确保 区 号 (area code) 和 电话 号 码 前 缀 (phone number prefix) 都 不 以 0 或 1 开头 ， 并 且 人 允许 用 户 在 电话 号 码 的 各 个 部 分 之 间 添 加 分 隔 符 (分隔 符 可 以 是 空格 、 连 
FEROA) 。 换 句 话 说， 用 上 面 这 种 单行 的 正则 表达 式 来 摘 述 电话 号 码 是 相当 合适 的 ， 但 它 并 不 是 十 分 精准 。 


解决 方案 6-10 采 用 这 种 正则 表达 式 来 判断 用 户 输入 的 是 不 是 电话 号 码 。 如 果 友 现 用 户 输入 了 格式 正确 的 电话 号 码 ， 那 么 程序 残 更 新 导航 栏 的 标题 ， 以 此 告知 用 户 
该 输入 是 有 效 的 。 这 条 解决 方案 演示 了 怎样 实时 地 过 滤 用 户 所 输入 的 内 容 ， 以 判断 其 是 否 与 待 想 配 的 模式 相符 ， 并 在 相符 的 时 候 做 出 响应 。 


6.10.2” 枚 举 正则 表达 式 \ 


NSRegularExpression 类 提供 了 一 种 基于 块 的 枚 举 万 式 ， 可 以 用 来 寻找 字符 串 中 与 正则 表达 了 式 相 匹 配 的 各 个 部 分 。 我 们 可 以 用 这 种 方式 对 特定 范围 内 的 文本 做 出 
修改 。 如 果 发 现 某 段 文本 与 正则 表达 式 相 匹配 ， 那 么 可 通过 带 属性 的 文本 (attributed text) 来 设置 其 颜色 或 字体 ， 以 便 向 用 户 凸 显 这 些 内 容 。 这 种 做 法 与 文本 视图 的 
拼写 检查 器 相似 ， 后 者 会 给 拼 错 的 单词 添加 下 划 线 。 


如 果 想 自己 来 实现 这 种 效果 ， 那 么 就 请 创建 一 条 正则 表达 式 ， 然 后 将 它 与 字符 串 (这 个 字符 串通 党 是 从 文本 视图 之 类 的 控件 中 获取 的 ) 相 匹配 ， 并 企 每 一 个 能 够 
匹配 的 泥 围 (NSRange) 内 ， 为 文本 施加 某 种 视 沉 效果。 通过 市 属性 的 字符 串 (attributed string) ,我们 可 以 用 一 种 比 早 前 iOS 系 统 更 为 简单 的 万 式 来 修改 文本 视图 
的 内 容 ， 从 而 向 用 尸 提 供 视 党 反馈 效果 : 


// Check for matches 

NSRegularExpression *regex = [NSRegularExpression 
regularExpressionWithPattern:@"REGEXHERE" 
options:NSRegularExpressionCaseInsensitive error:nil]; 


// Enumerate over a string 
[regex enumerateMatchesInString:text options:0 range:fullRange 


usingBlock:^(NSTextCheckingResult *match, 
NSMatchingFlags flags, BOOL *stop) { 
NSRange range = match.range; 


// Perform some action on the range 


}]; 


6.10.3 “数据 探 则 器 


NSDataDetector 类 是 NSRegularExpression 的 子 类 。 数 据 探测 器 (data detector) 可 用 来 判断 那些 定义 明确 的 数据 类 型 ， 包 括 日 期 、 地 址 、URL 链 接 、 电 话 号 
码 以 及 交通 信息 等 ， 苹 果 公 司 已 经 彻底 测试 了 相关 算法 ， 所 以 开 友 者 不 用 自己 再 去 创建 正则 表达 式 了 。 而 且 还 有 个 好 处 ， 融 是 这 些 检测 都 已 经 本 地 化 (localized) 
Te 


我 们 采用 与 上 一 节 相 同 的 办 法 来 遍历 字符 串 中 与 正则 表达 式 相 匹配 的 各 个 部 分 。 下 面 这 段 代码 会 搜寻 字符 串 里 的 链接 (也 融 是 URL) 和 电话 号 码 : 


NSError *error = NULL; 
NSDataDetector *detector - [NSDataDetector dataDetectorWithTypes: 
NSText CheckingTypeLink | NSText CheckingTypePhoneNumber 
error:&error]; 


// Enumerate over a string 
[detector enumerateMatchesInString:text options:0 range:fullRange 
usingBlock:^(NSTextCheckingResult *match, 
NSMatchingFlags flags, BOOL *stop) { 
NSRange range = match.range; 
// Perform some action on the range 


H; 


仿 查 功能 是 围绕 着 NSTextCheckingResult 类 而 构建 的 ， 该 类 描述 了 与 数据 探测 器 所 能 友 现 的 内 容 相 匹 配 的 信息 。iOS 的 数据 探测 器 所 支持 的 数据 种 类 会 不 断 地 增 


加 。 目 前 支持 的 数据 有 日 期 (NSTextCheckingTypeDate) 、 地 址 (NSTextChecking-TypeAddress) 、 链 接 (NSTextCheckingTypelink) 、 电 话 号 码 
(NSTextChecking-TypePhoneNumber) 以 及 航班 等 交通 信息 (NSTextCheckingTypeTransitInformation) 。 和 希望 将 来 还 能 支持 更 多 的 类 型 ， 比 如 常用 的 股票 代 
码 、UPS/FedEx 运 单 号 码 以 及 其 他 易于 辨识 的 文本 形式 。 


6.10.4 ”使 用 内 置 类 型 的 探测 器 


UlTextView 及 UIWebView 提 供 了 内 置 的 数据 类 型 探测 器 ， 能 够 辨识 电话 号 码 、HTTP 链 接 等 内 容 。 开 发 者 设置 了 dataDetectorTypes 属 性 之 后 ， 视 图 就 会 自动 把 
与 文本 模式 相 匹 配 的 内 容 转 换 成 可 以 点 击 的 URL， 并 将 其 座 入 到 视图 的 文本 里 。 可 以 设置 的 数据 类 型 包括 地 址 、 日 历 事件 、 链 接 以 及 电话 号 码 。 如 果 将 属性 设 为 
UlData-DetectorTypeAll， 那 么 就 可 以 匹配 所 有 支持 的 数据 类 型 ， 若 设 为 UIDataDetector-TypeNone， 则 会 禁用 模式 匹配 功能 。 


6.10.5 有 用 的 网 站 


使 用 正则 表达 式 的 时 候 ， 下 列 网 站 可 能 会 对 编程 工作 有 所 帮助 : 

- Regular Expression Library 网 站 (http://regexlib.com/) 列 出 了 全 球 网 友 所 贡献 的 上 千 个 正则 表达 式 。 

Regex Pal 网 站 (http://regexpal.com/) 提供 了 互动 式 的 JavaScript 工 具 ， 用 于 测试 正则 表达 式 。 

txt2re 生 成 器 (http://txt2re.com/) 可 以 根据 访问 者 所 提供 的 源 字 符 串 构建 一 段 程序 码 ， 这 段 程序 码 用 正则 表达 式 把 字符 串 里 与 之 相 匹配 的 各 部 分 提取 出 来 。 
Qaz 由 于 iOS 7 支持 Text Kit, PA T14 A UI TextField tJ &4€z 5b, RAET VALE f A 386-9 Fe6-10 F 28 5 NS TextStorage 9 FH, ŽA "S processEditing Zr i . 


解决 方案 6-10 ”用 谓词 和 正则 表达 式 检测 文本 模式 


@implementation TestBedViewController 


{ 
UITextField *textField; 
UISegmentedControl *segmentedControl; 
} 
- (void)updateStatus: (NSString *)string 
| 


// This is a predicate matching U.S. telephone numbers 
NSPredicate *telePredicate - [NSPredicate predicateWithFormat: 


@"SELF MATCHES \ 
'*C\\ (1? ( [2-9] [0-9] {2}) (\\)]?0-.-\\. 1? ([2-9] [0-9] {2})\ 
[-.\\. ]?((0-9] {4})$'"]; 
BOOL match [telePredicate evaluateWithObject:string]; 
self.title match ? @"Phone Number" : nil; 


- (BOOL)textField: (UITextField *)aTextField 
shouldChangeCharactersInRange: (NSRange)range 
replacementString: (NSString *)string 


NSString *newString - [textField.text 
stringByReplacingCharactersInRange:range withString:string] ; 
if (!string.length) 
{ 
[self updateStatus:newString] ; 
return YES; 


NSMutableCharacterSet *cs = [NSMutableCharacterSet 
characterSetWithCharactersInString:@""] ; 
[cs formUnionWithCharacterSet: 
[NSCharacterSet decimalDigitCharacterSet]]; 
[cs addCharactersInString:@"()-. "]; 


// Legal characters check 

NSString *filtered = [[string componentsSeparatedByCharactersInSet: 
[cs invertedSet]] componentsJoinedByString:@""] ; 

BOOL basicTest = [string isEqualToString: filtered] ; 


// Test for phone number 
[self updateStatus:basicTest ? newString : textField.text]; 


return basicTest; 


- (void) loadView 


| 


self.view [[UIView alloc] init]; 

textField [[UITextField alloc] initWithFrame: 
CGRectMake(0.0f, O.Of, 300.0f, 30.0£)]; 

textField.placeholder = @"Enter Phone Number"; 

[self.view addSubview:textField] ; 


PREPCONSTRAINTS (textField) ; 
CONSTRAIN(self.view, textField, @"V:|-30-[textField]") ; 
CONSTRAIN(self.view, textField, @"H:|-[textField(>=0)]-|"); 


textField.delegate - self; 


textField.returnKeyType - UIReturnKeyDone; 
textField.clearButtonMode = UITextFieldViewModeAlways; 
textField.borderStyle - UITextBorderStyleRoundedRect; 
textField.autocorrectionType - UITextAutocorrectionTypeNo; 


@end 


6.11 解决 方案 : 检测 UITextView 中 的 拼写 错误 


UlTextChecker 类 可 以 自动 扫 摘 出 文本 里 的 拼写 错误 。 使 用 这 个 类 的 时 人 息 ， 必 须 先 设置 目标 语言 ， 比 方 说 ，en 表 示 喘 语 、en_US 表 示 美 国 严 语 ，fr_CA 表 示 加 拿 大 
法 语 。 语 言 码 由 1SO 639-1 编 码 和 可 选 的 |SO 3166-1 区 域 码 组 成 。 我 们 可 以 把 目标 语言 设 为 en， 这 样 就 会 以 通用 的 严 语 字典 来 检查 拼写 了 ， 也 可 以 将 其 设 为 en_US、 
en_AU 或 en _GB， 以 便 用 美国 英语 、 澳 大 利 亚 英 语 或 英国 英语 字典 来 检查 拼写 。 开 有 友 者 可 以 从 UITextChecker 中 获取 一 份 数组 ， 它 里 面 询 出 了 可 供 选 用 的 各 种 语言 。 


UITextChecker 类 能 够 学 习 新 词 (learnWord: ) 也 可 以 扎 挥 已 经 学 会 的 词 (unlearnWord: ) ， 这 使 得 程序 可 以 根据 用 户 的 需求 来 定制 系统 自 市 的 字典 。 已 经 
学 会 的 那些 词 都 是 跨 语言 使 用 的 ， 所 以 ， 如 果 向 字典 中 添加 了 某 个 人 名 ， 那 么 该 名 字 在 每 一 种 语言 环境 下 均 可 使 用 。UITextChecker 对 象 也 提供 了 一 些 实例 方法 ， 用 
来 设置 拼写 检查 时 可 以 忽略 的 词 。 


解决 方案 6-11 会 逐次 选中 每 一 个 拼 错 的 词 ， 以 此 演示 如 何 将 UITextChecker 集 成 到 应 用 程序 中 。 为 了 实现 此 功能 ， 需 要 控制 每 次 在 文本 视图 里 所 选 定 的 文本 范 
围 。 若 想 在 UITextView 中 选取 文本 ， 它 必须 首先 具备 第 一 咽 应 者 的 身份 才 行 。 我 们 用 下 列 代码 检查 其 是 否 具 备 响应 者 (responder) 身份 ， 若 不 具备 该 身份 ， 则 令 其 
成 为 响应 者 : 


if (![textView isFirstResponder]) 
[textView becomeFirstResponder] ; 


接 下 来 计算 要 选中 的 文本 范围 (计算 时 要 考虑 到 文本 长 度 ) ， 并 设置 文本 视图 的 selectedRange 属 性 : 
textView.selectedRange = NSMakeRange(offset, length); 


除了 要 具备 第 一 响应 者 的 身份 之 外 ， 文 本 视图 还 必须 能 够 编辑 (editable) ， 在 这 种 情况 下 ， 只 要 选中 了 其 中 的 内 容 ， 屏 幕 上 融会 出 现 键盘 。 由 于 用 户 可 能 会 用 键 
盘 来 编辑 文本 ， 所 以 程序 代码 必须 考虑 到 编辑 操作 会 干扰 应 用 程序 的 情况 。 


解决 方案 6-11 搜寻 拼写 错误 
Gimplementation TestBedViewController 
- (void)nextMisspelling: (id)sender 
| 
if (![textView isFirstResponder]) 


[textView becomeFirstResponder]; 


NSRange entireRange - NSMakeRange(0, textView.text.length); 


// Scan for a new word from the current offset 
NSRange range - [textChecker 
rangeOfMisspelledWordInString:textView.text 
range:entireRange 
startingAt:textOffset 
wrap:YES language:G"en"|; 


// Skip forward each time a new misspelling is found / select the word 
if (range.location !- NSNotFound) 


| 


textOffset = range.location + range.length; 
textView.selectedRange - range; 


| 


else 
textOffset - 0; 


@end 


拼写 检查 器 协议 
我 们 可 以 给 NSString 添 加 一 个 方便 的 小 协议 (little protocol) ， 通 过 UITextChecker 来 检查 任意 字符 串 的 拼写 是 否 正确 (如 程序 清单 6-1 所 示 ) 。 


程序 清单 6-1 拼写 检查 器 协议 


Gimplementation NSString (SpellCheck) 
- (BOOL)isSpelledCorrectly 


| 


UITextChecker *checker - [[UITextChecker alloc] init]; 

NSRange checkRange - NSMakeRange(0, self.length); 

NSString *language = [[NSLocale currentLocale] 
objectForKey:NSLocaleLanguageCode] ; 

NSRange range - [checker rangeOfMisspelledWordInString:self 
range:checkRange startingAt:0 wrap:NO language:language]; 

return (range.location == NSNotFound) ; 


@end 


6.12 ”搜寻 文本 中 的 子 待 串 


对 解决 方案 6-11 做 一 些 改编 ， 即 可 实现 文本 搜寻 功能 。 为 了 实现 此 功能 ， 需 要 给 导航 栏 添加 一 个 文本 框 ， 并 把 导航 栏 上 面 的 按钮 改 为 Find， 然 后 用 NSstring 的 
rangeOfString: options: range: 方法 来 定位 待 搜寻 的 字符 串 。 请 注意 ， 要 搜寻 的 字符 串 不 能 是 nil。 在 目标 文本 中 找到 与 字符 串 相 匹 配 的 范围 之 后 (假设 匹配 位 置 
不 是 NSNotFound) ， 可 调用 文本 视图 的 scrollRangeToVisible: 方法 ， 将 其 滚动 到 这 个 位 置 上 。 调 用 该 方法 时 ， 要 把 刚才 rangeOfstring: options: range: 方法 
所 返回 的 范围 传 进去 。 


Qi NSNotFound 是 个 常量 ， 用 来 表示 没 能 成 功 地 定位 到 相关 范围 。 搜 索 完 之 后 请 检查 NSRange 的 location 字 段 ， 以 确保 其 值 是 有 效 的 。 


6.13 “人 小结 


本 章 介绍 了 在 iOs 应 用 程序 里 使 用 文本 的 许多 种 新 方式 。 在 这 一 章 中 ， 读 者 看 到 了 如 何 控制 键盘 以 及 如 何 调整 视图 ， 使 其 与 市 键盘 的 文本 输入 界面 相 匹配 。 我 们 还 
讲解 了 怎样 创建 自 定 义 的 输入 视图 、 怎 样 过 滤 文 本 以 及 怎样 判断 用 尸 所 输入 的 内 容 是 否 有 效 。 在 阅读 下 一 章 之 前 ， 请 回顾 下 列 问题 : 


“ 不 要 预先 假定 用 户 会 使 用 或 不 会 使 用 蓝牙 键盘 。 开 发 者 应 该 用 软件 键盘 及 硬件 键盘 这 两 种 输入 方式 来 测试 应 用 程序 。 


` 虽说 辅助 视图 是 一 种 向 文本 输入 界面 里 添加 额外 功能 的 好 办 法 ,但 也 不 要 过 度 使 用 它 。iPhone 和 iPod touch 的 键盘 本 身 已 经 占据 了 很 大 一 部 分 屏幕 。 如 果 再 添加 
辅助 视图 的 话 ， 就 会 进一步 缩减 用 户 可 以 看 到 的 屏幕 空间 。 若 要 使 用 辅助 视图 ， 则 应 尽量 将 其 设计 得 简单 一 些 。 


: 别 以 为 用 户 会 使 用 晃动 撤销 (shake-to-undo) 功能 ， 这 个 功能 的 实用 程度 值得 怀疑 。 我 们 应 该 直接 在 应 用 程序 的 GUI 里 面 提供 撤销 / 重 做 Undo/Redo 功 能 ， 令 用 户 
立刻 就 能 使 用 它们 ， 而 不 是 令 其 去 回想 革 果 公司 最 近 引 入 的 那个 比较 隐 上 的 撤销 方式 。 晃 动 撤 销 功 能 应 该 用 来 补充 现 有 的 撤销 / 重 做 功能 ， 而 不 是 替换 它们 。 在 附属 视 
图 上 添加 Undo/Redo 按 钮 是 非常 合适 的 。 


` 在 检测 用 户 所 输入 的 内 容 时 ， 可 能 找 不 到 非常 完美 的 正则 表达 式 ， 但 我 们 不 应 该 因为 不 够 完美 就 齐 用 那些 能 够 履 盖 大 多 数 情况 的 式 子 。 另 外 请 不 要 忘记 ， 可 以 
依次 使 用 多 个 正则 表达 式 来 测试 同一 问题 的 不 同 解法 。 


看 看 Text Kit 所 提供 的 新 特性 。Text Kit 比 Core Text 好 用 得 多 ， 而 且 提 供 了 很 多 灵活 的 功能 ， 用 以 实现 文本 泻 染 及 文本 输入 。 


第 7 草 ”使 用 视图 控制 器 


视图 控制 器 简化 了 许多 iOS 应 用 程序 的 视图 管理 。 每 个 视图 控制 器 都 拥有 一 套 视 图 层级 ， 这 套 层 级 完整 地 体现 了 用 户 界面 内 的 所 有 元 件 。 在 构建 应 用 程序 时 ， 开 发 
者 可 以 把 许多 任务 集中 到 视图 控制 器 里 面 来 做 ， 比 方 说 处 理 屏 幕 方向 的 变更 以 及 应 对 用 户 的 操作 等 。 本 章 讲解 如 何 使 用 基于 视图 控制 器 的 类 以 及 怎样 用 它们 来 设计 实 
用 的 iPhone/iPod 及 iPad 程 序 。 


7.1 视图 控制 器 


顾名思义 ， 视 图 控制 器 融 是 jiOS Model-View-Controller (模型 -视图 -控制 器 ) 设计 模式 中 的 Controller 部 分 。 每 个 视图 控制 器 都 管理 着 一 套 视 图 ， 这 些 视图 组 成 
了 程序 用 户 界 面 里 的 一 个 组 件 。 视 图 控制 器 负责 协调 视图 的 加 载 以 及 视图 的 样 狐 ， 同 时 还 会 响应 用 户 的 操作 。 


视图 控制 器 也 会 与 设备 及 底层 操作 系统 相配 合 。 比 方 说 ， 用 己 旋 转 设备 的 时 人 息 ， 视 图 控制 器 会 更 新 其 中 视图 的 布局 。 当 操作 系统 的 内 存 过 低 时 ， 控 制 器 也 会 对 内 
存 警 告 做 出 响应 。 


简 言 乙 ， 视 图 控制 器 提供 了 集中 管理 机 制 。 它 会 处 理 一 系列 各 目 独 立 的 开 友 需求 ， 这 些 需 求 可 能 是 由 视图 、 模 型 、iO3s 或 设备 本 身 所 引 友 的 。 


视图 控制 器 也 把 与 显示 方式 有 关 的 隐喻 集中 起 来 。 我 们 可 以 在 容器 里 面 分 层 添 加 视图 控制 器 ， 以 实现 出 非常 优秀 的 目 定 义 界面 。 系 统 提供 了 一 些 很 常用 的 父 视 图 / 
子 视图 型 视图 控制 器 ， 比 方 说 ， 导 航 控 制 器 使 得 用 尸 可 以 从 一 个 视图 切换 到 另 一 个 视图 ， 页 面 视图 控制 器 可 以 模仿 出 电子 书 的 效果 ， 标 签 栏 控制 器 (tab controller) 
提供 了 推 压 按 钮 (pushbutton) ， 使 得 用 户 可 以 在 多 个 子 控制 器 之 间 切 损 ， 而 分 栏 视图 控制 器 (split view controller) 则 可 以 把 主要 内 容 以 列表 形式 显示 在 一 边 ， 同 
时 把 细节 信息 展示 在 另 一 边 。 


视图 控制 器 本 身 并 不 是 视图 ， 而 是 一 种 没有 视 党 样 狐 的 类 ， 它 管理 痢 视 图 。 借 助 视图 控制 器 ， 开 妈 者 能 够 把 视图 放 企 比较 大 一 些 的 应 用 程序 里 面 使 用 。 


iOS SDK 提 供 了 许多 视图 控制 器 类 。 有 些 比较 通用 ， 有 些 比较 具体 。 下 面 简单 介绍 其 中 几 种 视图 控制 器 ， 大 家 在 构建 iOS 应 用 程序 的 界面 时 会 遇 到 它们 。 


7.1.1 UlViewController 类 
UlViewController 是 其 他 视图 控制 器 类 的 父 类 ， 它 用 来 管理 主 视图 ， 视 图 控制 器 的 很 多 工作 都 由 这 个 类 来 完成 。 开 发 者 需要 花 很 大 一 部 分 时 间 来 定制 这 个 类 的 子 
类 。 基 本 的 UIViewController 类 能 够 管理 主 视图 从 局 动 到 结束 的 整个 生命 期 ， 并 且 会 把 此 过 程 中 某 些 必须 响应 的 变化 考虑 进来 。 


UlViewController 实 例 负责 配置 视图 的 样 狗 以 及 它 所 要 显示 的 子 视图 。 一 般 来 说 ， 它 要 从 XIB 或 故事 板 文件 中 加 载 这 些 信息 。 此 外 ， 它 也 提供 了 一 些 实例 方法 ， 使 
开发 者 可 以 用 代码 来 手工 创建 视图 布局 (loadView) ， 或 在 视图 加 载 完 毕 之 后 添加 行为 (viewDidLoad) , 


视图 控制 器 还 有 另外 一 个 职责 ， 融 是 响应 正在 显示 出 来 或 正 要 隐藏 起 来 的 视图 。 对 于 大 型 应 用 程序 中 的 视图 来 说 ， 视 图 控制 器 确实 要 处 理 这 些 事 。 开 发 者 可 以 在 
viewWillAppear: 及 viewWillDisappear: 等 万 法 中 完成 与 视图 管理 有 关 的 例 行 任务 。 我 们 可 以 在 视图 显示 之 前 预先 加 载 数据 ， 也 可 以 在 视图 即将 消失 时 清理 资源 。 


上 面 提 到 的 每 件 任务 都 描述 了 视图 与 其 外 围 应 用 程序 之 间 的 某 种 配合 方式 。UIView Controller 是 用 来 协调 视图 和 外 部 需求 的 ， 它 会 令 视图 自身 发 生 改 变 ， 以 满足 


那些 需求 。 


7.1.2 “导航 控制 器 


从 名 称 可 知 ， 导 航 控 制 器 是 一 种 可 以 在 树 状 视图 层级 之 间 上 下 游 走 的 控制 器 ， 对 于 比较 小 的 iOS 设 备 来 说 ， 这 是 一 种 重要 而 常见 的 界面 设计 方式 ， 而 对 于 平板 电脑 
来 说 ， 它 也 可 以 用 作 辅 助 的 设计 方案 。 导 航 控 制 嚣 会 在 屏幕 上 方 创建 半 透 明 的 导航 栏 ， 很 多 iOS 应 用 程序 里 都 能 看 见 这 种 效果 。 


通过 导航 控制 器 ， 我 们 可 以 把 新 的 视图 晋 放 在 已 有 的 视图 之 上 ， 此 时 会 自动 生成 Back 按 钮 ， 该 按钮 会 显示 出 上 一 个 视图 控制 器 的 标题 。 所 有 的 导航 控制 器 都 使 用 
根 视图 控制 器 来 建立 导航 树 ， 这 个 根 控制 器 位 于 树 状 结构 顶端 ， 这 样 做 使 得 用 户 可 以 通过 Back 按 钮 返回 主 视图 。 在 平板 电脑 上 ， 我 们 可 以 把 基于 导航 控制 器 的 界面 与 
基于 UIBarButtonltem 的 菜单 项 结合 起 来 ， 以 产生 popover 式 的 显示 效果 ， 也 可 以 把 它 和 UlsplitViewController 实 例 相 集成 ， 实 现 出 主要 内 容 与 详细 信息 

(master/detail) 分 栏 展示 的 效果 。 


把 界面 导航 这 一 功能 交 给 导航 控制 器 之 后 ， 开 上 友 者 融 可 以 专心 地 设计 用 户 界 面 ， 并 为 每 个 视图 控制 器 创建 相应 的 屏幕 。 我 们 不 用 担心 具体 的 导航 细节 ， 只 需 告诉 
导航 控制 器 接 下 来 要 切换 到 哪个 视图 束 行 。 系 统 会 自动 把 原来 的 视图 区 放 起 来 ， 并 处 理 好 导航 按钮 。 


7.1.3 ”标签 栏 控制 器 


通过 UlTabBarController 类 ， 我们 可 以 在 应 用 程序 里 控制 许多 平行 的 内 容 。 这 有 点 像 收音 机 的 选 合 机制 。 不 需要 有 特定 的 导航 体系 ， 用 户 就 可 以 通过 标签 栏 
来 “ 调 ” 到 自己 喜欢 的 视图 控制 器 上 面 。 这 些 平行 的 内 容 都 是 各 自 独立 的 ， 而 且 可 以 具备 自己 的 导航 体系 。 开 发 者 构建 出 与 每 个 Tab (标签 ) 相对 应 的 视图 控制 器 或 导 
航 控 制 器 ， 而 Cocoa Touch 则 会 把 这 些 视图 的 相关 细节 处 理 好 。 


比方 说 ， 标 签 栏 上 面 同 时 出 现 的 视图 控制 器 如 果 超 过 一 定数 量 (在 iPhone 手机 上 面 是 59? 个， 平板 电脑 上 会 更 多 ) ， 那 么 用 户 就 可 以 通过 More>Edit 画 面 来 定制 它 
们 。 在 这 个 画面 中 ， 用 户 可 以 把 他 们 喜欢 的 控制 器 拖 放 到 屏幕 底部 的 按钮 栏 中 。 开 发 者 不 用 编写 额外 的 代码 ， 束 能 为 程序 添加 自由 调整 Tab 的 功能 。 我 们 要 做 的 只 是 配 
置 一 下 customizable-ViewControllers 属 性 。 


7.1.4 “分 柱 视 图 控制 器 


这 种 视图 控制 器 适用 于 平板 电脑 上 面 的 应 用 程序 ，UlsplitViewController 类 可 以 把 一 组 固定 的 数据 (通常 是 一 张 表格 ) 封装 起 来 ， 并 将 它们 和 细节 展示 界面 相关 
联 。iPad 的 Mail 程 序 里 融会 出 现 这 种 分 枉 视 图 (Split View) 。 在 横 屏 模式 下 ， 消 息 列 表 出 现在 屏幕 左 侧 ， 而 每 个 消息 的 内 容 则 显示 和 企 右 侧 。 右 侧 的 细节 视图 (ERE 
Mail 程 序 里 的 消息 内 容 ) 从 属于 左 侧 的 主 视图 (也 就 是 Mail 程 序 的 消息 列表 ) 。 避 击 某 条 消息 之 后 ， 右 侧 的 视图 融会 随 之 更 新 ， 并 将 这 条 消息 的 内 容 显示 出 来 。 


在 竖 屏 模式 下 ， 主 视图 通常 是 隐藏 起 来 的 。 用 尸 点 击 分 栏 视图 左上 和 角 的 按钮 ， 程 序 束 会 把 主 视图 以 popover 的 形式 展现 出 来 ， 在 iOS 5.1 及 其 后 的 系统 里 ， 用 尸 也 
可 以 通过 滑动 手势 来 访问 主 视图 。 


7.1.5 页面 钢 图 控制 器 


与 导航 控 制 器 、 标 签 栏 控制 器 、 分 栏 视图 控制 器 等 相似 ， 页 面 视图 控制 器 也 是 存放 其 他 视图 控制 器 的 一 种 容器 。 它 以 页 面 为 单位 来 管理 其 内 容 ， 并 且 可 以 用 书本 
那样 的 翻 页 形式 或 是 滚动 形式 来 展示 这 些 内 容 。 如 果 开 友 者 要 使 用 翻 页 模式 ， 融 需要 设置 “ 书 背 ”， 一 般 来 进 ， 书 背 位 于 视图 左 侧 或 顶部 。 然 后， 我 们 把 每 个 视图 控 
制 器 当 作 书 中 的 一 页 内 容 ， 添 加 到 页 面 视图 控制 器 里 面 ， 以 便 制 作 好 这 本 “ 书 ”。 用 户 可 以 通过 翻 页 或 拖 动 操作 人 在 页 面 之 间 切 换 。 


7.1.6 “popover 控 制 器 


popover 控 制 器 专门 用 于 平板 电脑 ， 这 种 控制 器 会 在 现 有 的 界面 内 容 上 方 弹 出 临时 的 视图 。popover 控 制 器 所 展示 出 来 的 信息 和 一 般 的 模 态 视图 相似 ， 都 不 会 占据 
整个 屏幕 。 用 户 通常 是 通过 点 击 界 面 里 的 UlBarButtonltem 来 弹出 这 种 popover 的 (开发 者 也 可 以 用 其 他 的 交互 技术 来 创建 popover) ， 当 操作 完 popover 中 的 内 容 ， 
或 是 在 主 视图 范围 以 外 点 击 屏 幕 时 ，popover 就 会 消失 。 


popover 的 内 容 通 单 由 另 一 个 视图 控制 器 来 填充 。 我 们 可 以 先 把 那个 视图 控制 器 构建 好 ， 并 将 其 设 为 popover 的 ContentViewController 属 性 ， 然 后 再 把 popover 
显示 出 来 。 通 过 这 种 极为 灵活 的 编程 技巧 ， 我 们 可 以 把 能 够 放 在 标准 视图 控制 器 中 的 任意 内 容 都 展示 到 popover 里 面 去 。 


Qi. 从 iOS 5 开始 ， 开 发 者 可 以 在 UINavigationBar 的 子 类 里 把 自 定 义 的 内 容 集 成 到 程序 的 导航 栏 界面 中 。 请 在 UINavigationConttollet 的 初始 化 方法 
initWithNavigationBarClass: toolbarClass: 里 编写 相关 代码 。 


7.2 ”使 用 导航 控 制 器 与 分 栏 视图 控制 器 来 开 友 程序 


对 于 屏幕 空间 有 限 的 设备 来 说 ，UINavigationController 类 是 一 种 管理 界面 的 重要 方式 。 它 构建 出 的 虚拟 界面 比 设备 屏幕 要 大 得 多 ， 用 户 可 以 在 这 套 界 面 的 不 同 
层级 之 间 上 下 游 走 。 导 航 控 制 器 把 它 的 GUI 以 简洁 的 树 状 结构 组 织 起 来 ， 用 户 可 通过 按钮 及 选项 来 浏览 这 个 树 状 结构 。Contacts 与 Settings 程 序 里 都 能 见 到 导航 控制 
器 ， 用 户 选 取 了 某 个 内 容 之 后 ， 程 序 就 会 切换 到 新 的 画面 ， 而 当 用 户 按 下 Back 按 钮 时 ， 又 会 回 到 原来 的 画面 。 


很 多 标准 的 GUI 元 件 都 可 以 体现 出 导航 控制 器 在 应 用 程序 中 的 用 法 ， 如 图 7-1 左 侧 所 示 。 我 们 可 以 看 到 每 个 画面 顶部 导航 栏 里 的 大 按钮 ， 当 用 户 浏 览 下 一 级 界面 的 
时 候 ， 导 航 栏 左上 角 束 会 出 现 后 退 按钮 ， 另外， 导航 栏 右上 和 角 还 会 列 出 应 用 程序 的 其 他 功能 ， 例 如 Edit (编辑 ) 等 。 很 多 市 有 导航 控制 器 的 应 用 程序 都 是 以 滚动 列表 为 
中 心 而 构建 出 来 的 ， 深 动 列表 里 的 元 素 会 把 用 户 领 向 新 的 画面 ， 在 列表 中 ， 每 个 单元 格 右 侧 会 有 扩展 指示 器 (是 个 灰色 的 横向 V 形 图 案 (chevron) ) 或 详情 展示 按钮 

(是 个 市 圆圈 的 i 形 图 案 ) 。 
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图 7-1 iPhone 的 导航 控制 器 (如 左 侧 截图 所 示 ) 用 灰色 的 横向 V 形 图 案 来 提示 用 户 : 选中 某 个 内 容 之 后 ， 程 序 会 在 屏幕 上 显示 出 与 此 内 容 有 关 的 细节 视图 。 而 在 iPad 上 
面 〈 如 右 侧 截 图 所 示 ) ， 分 栏 视 图 控制 器 则 会 占据 整个 屏幕 ， 把 左 侧 的 导航 元 素 和 右 侧 的 细节 展示 界面 分 隔 开 


由 于 iPad 的 屏幕 比较 大 ， 所 以 不 需要 像 iPhone 手 机 那样 采用 导航 控制 器 来 节省 屏幕 空间 。 和 平板 电脑 上 的 程序 也 可 以 直接 使 用 导航 控制 器 ， 但 是 像 图 7-1 右 侧 截 图 
那样 ， 采 用 UlsplitViewController 来 设计 界面 ， 其 效果 会 更 加 符合 ijPad 这 种 大 屏幕 的 设备 。 


请 注意 图 7-1 左 侧 的 iPhone 界 面 和 右 侧 的 iPad 界 面 之 间 有 何 区 别 。iPad 的 分 栏 视 图 控制 器 里 没有 横向 的 V 形 图 案 。 用 户 点 击 某 个 元 素 之 后 ， 其 细节 数据 会 出 现在 同 
一 个 屏幕 右 侧 那 块 较 大 的 区 域 里 面 。 而 在 iPhone 上 ， 由 于 屏幕 空间 较 小 ， 所 以 界面 里 会 用 横向 的 V 形 图 案 来 提示 用 户 : 点 击 某 个 元 素 之 后 ， 屏 幕 上 会 弹出 新 的 视图 。 
这 两 种 界面 设计 方式 都 把 与 设备 屏幕 有 关 的 特征 考虑 进来 了 。 


iPhone 和 iPad 上 面 的 Inbox 视 图 都 采用 了 相似 的 导航 控制 器 元 件 。 它 们 包括 Back 按 钮 (|56 “<iCloud” 字样 的 那个 按钮 ) 、 选 项 按钮 (Edit 按 钮 ) 以 及 标题 栏 
中 的 描述 信息 (也 就 是 当前 的 文件 夹 Core iOS) 。 每 个 元 件 都 是 通过 导航 控制 器 的 API 创 建 出 来 的 ， 我 们 用 这 些 元 件 来 展示 与 电子 邮件 账户 及 其 收 件 箱 有 关 的 层级 结 
构 。 


这 两 套 界 面 在 导航 树 的 最 底层 有 所 区 别 。 树 状 数据 结构 中 ， 这 一 层 由 很 多 “树叶 ” (leaf) 组 成 ， 每 个 树叶 表示 一 条 电子 邮件 信息 。iPhone 系 列 的 界面 用 横向 的 V 
形 图 案 来 表示 每 个 树叶 节点 。 用 户 选 中 了 某 个 树叶 节操 之 后 ， 程 序 会 把 相应 的 视图 控制 器 区 放 在 导航 栈 (navigation stack) 上 面 。 而 iPad 程 序 则 不 会 这 样 做 。 
iPhone 程 序 是 用 横向 V 形 图 案 来 告诉 用 户 当 前 已 经 浏 护 到 整个 树 状 结构 最 底层 了 ， 但 iPad 程 序 不 使 用 这 种 图 案 ， 它 直接 把 该 节点 的 信息 展示 到 右 侧 的 视图 中 。 


iPhone 风 格 的 导航 控制 器 也 能 够 用 在 iPad 上 面 。iPad 程 序 在 显示 临时 的 popover 界 面 时 ， 可 以 使 用 标准 的 (也 丈 是 iPhone 风 格 的 ) 导航 控制 器 ， 由 于 此 时 的 
popover 视 图 比较 小 ， 而 且 生 命 期 又 很 短 ， 所 以 我 们 可 在 这 种 显示 空间 较 少 的 视图 里 采用 此 方案 。 如 果 不 是 这 种 情况 ， 那 么 iPad 应 用 程序 还 是 采用 能 够 覆盖 整个 屏幕 
范围 的 分 栏 视图 比较 好 。 


7.2.1 使 用 导 和 由 控制 器 与 导航 枝 


每 个 导航 控制 器 都 有 其 根 视图 控制 器 。 这 个 控制 器 位 于 导航 枝 的 底部 。 当 用 户 浏 览 模型 树 并 做 出 选择 时 ， 我 们 可 以 用 代码 把 其 他 控制 器 推 入 导航 栈 。 虽 说 树 状 结 
构 本 身 可 能 有 许多 分 广 ， 但 是 用 户 的 路 径 〈 融 是 用 户 浏 览 的 历史 ) 通常 是 一 条 和 直线， 它 描述 了 用 户 从 一 开始 到 现在 所 选取 的 各 个 选项 。 每 点 击 一 个 新 的 选项 ， 束 会 多 
出 一 层 导 航 记 录 ， 而 系统 也 会 在 新 的 视图 控制 器 入 栈 的 时 候 自 动 构建 出 Back 按 钮 。 


用 户 可 以 点 击 Back 按 钮 ， 令 当前 的 控制 器 从 枝 中 弹出 。 每 个 Back 按 钮 的 名 称 都 是 上 一 个 视图 控制 器 的 标题 。Back 按 钮 的 名 字 表 示 用 户 在 点 击 了 该 按钮 之 后 会 返回 
到 栈 中 的 哪个 控制 器 。 用 尸 可 以 一 直 向 上 返回 ， 直 到 根 控制 器 为 止 ， 然 后 就 不 能 再 继续 向 上 返回 了 。 因 为 根 控制 器 是 树 状 结构 的 根基 ， 我 们 不 能 跳 到 树 根 外 面 去 。 


即便 界面 里 只 有 一 个 视图 控制 器 ， 也 依然 可 以 采用 这 种 基于 栈 的 结构 来 设计 。 比 方 说 ， 有 时 候 我 们 只 想 使 用 UINavigationController 内 置 的 导航 栏 来 构建 一 个 简 
单 的 工具 ， 而 导航 栏 上 面 也 仪 仪 包含 两 个 表示 菜单 的 按钮 。 虽 说 这 种 情况 无 须 利用 栈 结 构 所 县 备 的 优势 ， 但 开发 者 仍然 要 通过 initWithRootViewController: 方法 把 
这 个 控制 器 设 为 根 控制 器 。 


7.2.2 ” 推 入 与 弹出 视图 控制 器 


开发 者 通过 pushViewController: animated: 方法 推 入 新 的 视图 控制 器 ， 以 便 向 导航 栈 中 添加 新 元 素 。 每 个 视图 控制 器 都 提供 了 navigationController 属 性 ， 该 
属性 指向 与 这 个 控制 器 相配 合 的 导航 控制 器 。 如 果 未 将 控制 器 推 入 导航 栈 ， 那 么 该 属性 就 是 nil。 


我 们 可 以 通过 navigationController 属 性 查 出 导航 控制 器 ， 并 在 其 上 调用 pushViewController: animated: 方法 ， 把 新 的 视图 控制 器 推 入 导航 栈 。 调 用 该 方法 之 
后 ， 新 的 控制 器 会 从 右 侧 滑 入 屏幕 (假设 调用 的 时 候 把 animated 参 数 设 为 了 YES) 。 这 时 会 出 现 一 个 带 左 箭头 的 Back 按 钮 ， 点 击 该 按钮 ， 就 可 以 回 到 栈 里 的 上 一 个 控 
制 器 了 。 设 置 backlndicatorlmage 属 性 ， 即 可 将 这 个 横向 的 V 形 图 案 换 成 自 定 义 的 图 像 。 在 履 写 苹果 公司 的 标准 元 件 时 一 定 要 多 加 小 心 ， 请 务必 和 《Apple Human 
Interface Guidelines》 (HIG) 的 宗旨 相符 。 


有 很 多 情况 都 需要 推 入 新 的 视图 。 一 般 来 说 ， 当 程序 需要 显示 诸如 细节 视图 等 专门 的 视图 时 ， 或 是 当 用 户 需 要 访问 下 一 级 文件 夹 、 下 一 级 配置 选项 时 ， 融 需要 推 
入 新 的 视图 了 。 我 们 可 以 在 用 户 点 击 了 按钮 、 表 格 项 或 disclosure 按 钮 的 时 候 ， 向 导航 控制 器 的 栈 里 推 入 新 的 视图 控制 器 。 


我 们 几乎 没有 什么 理由 去 编写 UINavigationController 子 类 。 在 UIView-Controller 的 子 类 中 ， 可 以 向 导航 控制 器 里 推 入 新 的 视图 控制 器 ， 也 能 够 定制 导航 栏 ( 比 


方 说 ， 可 以 设置 导航 栏 的 标题 或 按钮 ) 。 开 发 者 只 需 把 定制 好 的 子 控制 器 放 到 导航 控制 器 里 面 就 行 了 。 


-一 


在 大 多 数 情 况 下 ， 都 无 须 直 接 访问 导航 控制 器 。 但 在 管理 导航 栏 的 按钮 、 修 改 导航 栏 的 样 狐 或 用 自 定义 的 导航 栏 类 来 初始 化 的 时 候 ， 则 需要 访问 它 。 比 方 说 ,我 
们 可 以 用 类 似 下 面 这 样 的 代码 来 直接 访问 navigationBar 属 性 ， 并 修改 导航 栏 的 样式 或 tint color, 


self.navigationController.navigationBar.barStyle = 
UIBarStyleBlack; 


请 注意 ， 在 iOS 7 中 ， 苹 果 公司 添加 了 barTintColor 属 性 来 表示 导航 栏 背景 的 tint color， 而 原来 的 tintColor 属 性 则 用 来 表示 UIBarButtonltem 的 tint color 7 , 


7.2.3 “导航 栏 上 的 按钮 


如 果 想 添加 新 按钮 ， 可 以 修改 navigationltem 属 性 ， 该 属性 对 应 的 UINavi-gationltem 类 用 来 摘 述 显示 在 导航 栏 中 的 内 容 ， 其 中 包括 左 侧 和 右 侧 的 按钮 项 
(button item) ， 也 包括 标题 视图 (title view) 。 下 列 代码 可 用 来 设置 导航 栏 中 的 按钮 


self.navigationItem.rightBarButtonItem = [[UIBarButtonItem alloc] 
initWithTitle:@"Action" style:UIBarButtonItemStylePlain target:self 
action:Gselector(performAction:)]; 


若 想 移 除 按钮 ， 则 将 按钮 项 设 为 nil。 导 航 栏 上 的 按钮 项 (UlBarButtonltem) 并 不 是 视图 ， 它 们 是 一 种 包含 标题 、 样 式 及 回调 信息 的 类 ， 而 UlINavigationltem 和 
UlToolbar 则 会 用 这 个 类 来 构建 实际 的 按钮 ， 并 将 其 放 入 界面 之 中 。iOS 系 统 没有 提供 这 样 一 种 手段 ， 用 以 访问 由 UlBarButtonltem 及 其 UlINavigationltem 所 创建 出 来 
的 按钮 视图 (button view) 。 


MIOS 5 开始 ， 我 们 可 以 给 导航 栏 左右 两 侧 添 加 多 个 UlBarButtonltem。 把 数组 赋 给 navigationltem 的 rightBarButtonltems 或 leftBarButtonltems 属 性 (注意 最 
后 的 “s”) 即 可 : 


self.navigationItem.rightBarButtonItems - barButtonArray; 


7.24 SERS ASAT ZA 


IOS 7 的 设计 侧重 于 应 用 程序 的 内 容 ， 更 具体 地 襄 ， 融 是 展示 给 用 户 的 内 容 。 它 移 除 了 导航 栏 和 其 他 UI 元 件 的 边界 及 阴影 效果 ， 并 添加 了 半 透 明 效果 。 这 一 变化 会 
极 大 地 影响 视图 布局 ， 尤 其 是 使 用 了 导航 栏 的 视图 布局 。 

从 iOS 7 开始 ， 所 有 的 视图 控制 器 都 采用 全 屏 布局 (full-screen layout) 。UlIView-Controller 的 wantsFullscreenLayout 属 性 已 经 弃 用 了 ， 如 果 将 其 设 为 NO， 那 
么 可 能 会 导致 与 需求 非常 不 相符 的 布局 。 在 全 屏 布局 模式 下 ， 视 图 控制 器 会 令 它 的 视图 填 满 整个 屏幕 ， 并 出 现在 半 透 明 的 系统 状态 栏 下 方 。 而 且 在 默认 情况 下 ,，iOS 7 
会 把 所 有 bar ( 栏 ) 都 绘制 成 半 透 明 的 ， 以 便 显示 出 下 方 的 内 容 。 

由 于 应 用 程序 的 内 容 现在 会 延伸 到 bar 的 下 方 ， 所 以 我 们 不 能 再 按照 以 前 那 套 方 式 来 排 布 视图 。 排 布 视图 的 时 候 ， 必 须 把 状态 栏 及 程序 的 导航 栏 下 方 那 些 区 域 考虑 

UlViewController 提 供 了 一 些 新 的 布局 属性 ， 它 们 可 以 实现 更 为 精细 的 位 置 控制 。 在 子 类 中 实现 prefersStatusBarHidden 方 法 并 返回 适当 的 布尔 值 ， 即 可 在 视图 
控制 器 这 一 级 别 设置 状态 栏 是 否 可 见 。 开 发 者 还 可 以 通过 一 些 新 属性 ， 根 据 当 前 所 显示 出 的 bar 来 设置 视图 的 位 置 及 大 小 。 

通过 视图 控制 器 的 edgesForExtendedLayout 属 性 ， 我 们 可 以 指定 控制 器 是 否 应 该 把 视图 的 内 容 延 伸 到 半 透 明 的 bar 下 方 ， 并 达到 屏幕 边缘 。 该 属性 的 默认 值 是 
UIRectEdgeAll， 表 示 视 图 在 四 个 边界 方向 上 都 会 延伸 到 半 透 明 元 件 的 下 方 ， 如 图 7-2 左 侧 截 图 所 示 。 如 果 把 这 个 属性 设 为 UIRectEdgeNone， 那 么 内 容 视图 的 边界 在 


页 到 bar 之 后 就 不 继续 延 促 ， 如 图 7-2 右 侧 截 图 所 示 。 默 认 情 况 下 ，edgesForExtendedLayout- 属 性 在 延展 视图 的 时 候 ， 也 会 把 完全 不 透明 的 bar 考 虑 在 内 。 若 想 排除 
这 种 bar， 则 可 将 extendedLayoutincludesOpaqueBars 设 为 NO。 


系统 状态 栏 和 开发 者 自己 实现 的 bar (比如 navigation bar (Sint) . toolbar (工具 栏 ) 及 tab bar (标签 栏 ) ) 还 会 影响 到 滚动 视图 (scroll view) 的 布局 。 
在 默认 情况 下 ，UlScrollView 会 自动 调整 inset[1]， 以 便 应 对 这 些 bar 元 件 。 如 果 不 想 启用 这 种 行为 ， 而 是 想 手动 管理 UlScrollView 的 inset， 那 么 就 请 将 


automaticallyAdjustsScrollView-lnsets 设 为 NO。 


最 后 要 说 的 是 ，iOS 7 还 提供 了 topLayoutGuide 及 bottomLayoutGuide 属 性 ， 用 来 协助 我 们 排 布 视图 的 内 容 。 这 些 属 性 指定 了 屏幕 顶端 或 诬 端 那个 bar 的 边界 在 
视图 控制 器 的 视图 中 处 于 哪个 位 置 。 它 们 所 指 的 那 条 边界 会 随 着 屏幕 上 是 否 显示 各 种 bar 而 有 所 不 同 : 


Carrier = 12:30 PM Carrier = 12:30 PM 


UlRectEdgeAll UlRectEdgeNone 


图 7-2 iOS 7 中 ，UIViewController 的 edgesForExtendedLayout 属 性 用 来 在 排版 时 控制 视图 的 边界 位 置 。 默 认 值 是 UIRectEdgeAll， 它 表示 视图 的 边界 会 越过 半 透 明 的 bar， 
如 左 侧 截图 所 示 。 若 设 为 UIRectEdgeNone， 则 会 令 视 图 的 边界 在 bar 的 边缘 处 停止 延伸 ， 如 右 侧 截 图 所 示 


对 于 topLayoutGuide 来 说 : 

` 如 果 状 态 栏 可 见 但 没有 可 见 的 导航 栏 ， 那 么 就 表示 状态 栏 的 底 边 。 

. 如 果 有 可 见 的 导航 栏 ， 那 么 就 表示 导航 栏 的 底 边 。 

` 如 果 既 没有 可 见 的 状态 栏 ， 也 没有 可 见 的 导航 栏 ， 那么 就 表示 屏幕 上 沿 。 
对 于 bottomLayoutGuide 来 说 : 

` 如 果 有 可 见 的 工具 栏 或 标签 栏 ， 那么 就 表示 工具 栏 或 标签 栏 的 顶 边 。 

` 如 果 没 有 可 见 的 工具 栏 或 标签 栏 ， 那 么 就 表示 屏幕 底 边 。 


开发 者 可 以 用 这 些 属 性 来 创建 相对 的 约束 规则 ， 这 样 的 话 ， 我 们 既 不 用 考虑 frame 的 位 置 ， 也 不 用 预知 bar 是 否 可 见 ， 而 是 能 够 根据 bar 的 边界 来 排 布 子 视图 的 相 
对 位 置 。 在 Interface Builder (IB) 或 布局 代码 中 ， 可 以 将 其 同 Auto Layout 约 束 系统 结合 起 来 使 用 。 在 不 使 用 Auto Layout 的 时 候 ， 可 以 用 这 些 指 南 来 进行 基于 


frame 的 位 置 排 布 (frame-based positioning) 。 我 们 可 通过 指南 的 length 属 性 来 获知 相关 的 偏 移 量 。 


[1] 可 以 理解 成 视图 内 容 与 视图 边界 之 间 的 距离 。 


译 者 注 


7.3 ”解决 方案 : UlNavigationltem 类 


系统 会 用 UINavigationltem 类 的 对 象 来 生成 导航 栏 的 内 容 ， 该 类 存放 了 一 些 与 这 种 对 象 有 关 的 信息 。UINavigationltem 的 属性 包括 导航 栏 左 侧 与 右 侧 的 UlBar 
Buttonltem、 显 示 在 导航 栏 中 的 标题 、 用 来 显示 该 标题 的 视图 以 及 用 于 从 当前 视图 返回 到 上 一 个 视图 的 Back 按 钮 。 


通过 这 个 类 ， 可 以 把 按钮 、 文 本 及 其 他 UI 对 象 添加 到 三 个 关键 位 置 上 ， 这 三 个 位 置 分 别 是 导航 栏 的 左 侧 、 中 心 及 右 侧 。 一 般 情 况 下 ， 我 们 会 在 右 侧 放 置 普通 按 
钮 ， 在 中 间 写 上 一 些 文本 (通常 是 UIViewController 的 标题 ) ， 并 在 左 侧 放 置 Back 按 钮 。 但 开发 者 并 不 应 该 局 限于 这 种 布局 。 我 们 也 可 以 在 左 、 中 (标题 区 域 ) . A 
这 三 个 位 置 上 添加 自 定义 的 控件 。 比 方 说 ， 可 以 把 搜索 用 的 文本 框 、 分 段 选 择 控件 (segment control) 、 工 具 栏 或 图 片 等 放 在 导航 栏 中 间 。 而 且 还 可 以 把 许多 
UIBarButtonltem 放 在 数组 里 ， 并 添加 到 导航 栏 左右 两 侧 。UINavigationltem 修 改 起 来 是 非常 容易 的 。 


7.3.1 标题 与 后 退 按钮 
导航 栏 中 间 的 标题 区 是 可 以 定制 的 。 可 以 像 下 面 这 样 给 navigationltem 设 置 标 题 : 
self.navigationItem.title = @"My Title" 
上 面 这 行 代码 与 直接 设置 视图 控制 器 的 title 属 性 是 等 效 的 。 要 想 定 制 标 题 ， 最 简单 的 办 法 应 该 是 修改 子 视图 控制 器 的 title 属 性 ， 而 不 是 去 修改 navigationltemn : 
self.title = G"Hello"; 


导航 控制 器 会 用 这 个 title 属 性 来 构建 下 一 个 Back 按 钮 的 go back (返回 ) 文本 。 如 果 当 前 控制 器 的 标题 叫 作 "Hello"， 而 开发 者 又 向 导航 栈 里 推 入 了 一 个 新 的 控制 


器 ， 那 么 ， 新 控制 器 Back 按 钮 上 面 的 文本 也 会 是 "Hello"。 
你 还 可 以 把 文本 形式 的 标题 改 为 控件 之 类 的 自 定义 视图 。 下 面 这 段 代码 会 添加 自 定 义 的 分 段 选择 控件 ， 不 过 我 们 也 可 以 添加 图 像 视图 、 步 进 控件 等 其 他 东西 : 
self.navigationItem.titleView = 
[[UISegmentedControl alloc] initWithItems:items]; 
lad e 


由 于 创建 UlBarButtonltem 是 一 种 重复 性 非常 高 的 任务 ， 所 以 我 们 可 以 用 突 来 简化 它 。 下 面 这 个 宏 能 够 创建 基本 的 按钮 项 : 


#define BARBUTTON(TITLE, SELECTOR) [[UIBarButtonItem alloc] V 
initWithTitle:TITLE style:UIBarButtonItemStylePlain V 
target:self action:SELECTOR] 


各 想 调 用 上 面 这 个 安 ， 只 需 给 出 标题 和 选择 子 就 可 以 了 。 由 于 每 次 调用 安 的 时 候 都 只 需 指 定 标题 和 选择 子 这 两 条 信息 ， 所 以 这 种 写法 要 比 直 接 创 建 
UIBarButtonltem 更 容易 读 懂 :: 


self .navigationItem.rightBarButtonItem = 
BARBUTTON(@"Push", @selector (push: ) ) ; 


该 版 本 的 宏 假 设 目标 束 是 "self”( 自 己 ) ， 这 很 符合 常见 的 用 法 ， 不 过 ， 也 可 以 对 此 稍 加 改编 。 下 面 这 个 宏 束 可 以 令 开发 者 手工 指定 目标 : 


#define BARBUTTON TARGET(TITLE, TARGET, SELECTOR) ^ 
[[UIBarButtonItem alloc] initWithTitle:TITLE \ 
style:UIBarButtonItemStylePlain target:TARGET action:SELECTOR] 


UIBarButtonltem 的 用 法 会 随 着 应 用 程序 的 特定 需求 而 有 所 变化 。 我 们 很 容易 就 能 创建 出 一 些 安 ， 令 其 用 苹果 公司 所 提供 的 系统 控件 来 制作 UIBarButtonltemn， 
或 是 令 其 根据 图 片 资源 来 制作 带 有 图 像 的 UIBarButtonltem ， 还 可 以 令 其 创建 自 定 义 的 视图 ， 并 在 其 中 众 入 别 的 控件 以 及 非 UIBarButtonltem 式 的 按钮 (non-bar 
button) ， 然 后 用 这 种 自 定义 的 视图 来 制作 UIBarButtonltem。 


解决 方案 7-1 把 这 些 技 5 结 合 起 来 ， 实 现 了 上 下 级 界面 之 间 的 切换 ， 并 且 示 范 了 如 何 定 制 子 控制 器 的 标题 栏 以 及 导航 控制 器 的 navigationltem。 它 构建 了 一 套 非常 
简单 的 界面 : 用 户 根 据 屏 幕 上 列 出 的 几 个 标题 ， 自 己 来 选择 想 要 推 入 导航 栈 的 下 一 个 子 控制 器 ， 然 后 按 Push 按 钮 将 其 推 入 。 通 过 此 程序 ， 我 们 可 以 了 解 导航 控制 器 的 
栈 在 一 般 情 况 下 是 如 何 增长 的 。 


解决 方案 7-1 用 导航 控制 器 企 上 下 级 界面 乙 间 切 换 


// Array of strings 
- (NSArray *) fooBarArray 


| 


return [@"Foo*Bar*Baz*Qux" componentsSeparatedByString:@"*"] ; 


// Push a new controller onto the stack 
- (void) push: (1d) sender 
| 
NSString *newTitle - 
[self fooBarArray] [seg.selectedSegment Index] ; 


UIViewController *newController - 

[[TestBedViewController alloc] init]; 
newController.edgesForExtendedLayout = UIRectEdgeNone; 
newController.title = newTitle; 


[self .navigationController 
pushViewController:newController animated: YES]; 


- (void) loadView 

| 
self.view = [[UIView alloc] init]; 
self.view.backgroundColor = [UIColor whiteColor] ; 


// Establish a button to push new controllers 
self.navigationItem.rightBarButtonItem = 
BARBUTTON (@" Push", Gselector(push:)); 


// Create a segmented control to pick the next title 

seg = [[UISegmentedControl alloc] initWithItems: 
(self fooBarArray] ]; 

seg.selectedSegmentIndex = 0; 

[self.view addSubview:seg] ; 

PREPCONSTRAINTS (seg) ; 


UILabel *label - 

[self labelWithTitle:@"Select Title for Pushed Controller"); 
[self.view addSubview: label]; 
PREPCONSTRAINTS (label) ; 


id topLayoutGuide = self.topLayoutGuide; 
CONSTRAIN(self.view, label, @"H:|-[label(>=0)]-|"); 
CONSTRAIN(self.view, seg, @"H:|-[seg(>=0)]-|"); 
CONSTRAIN VIEWS (self .view, 
@"V: [topLayoutGuide] - [label] - [seg] ", 
NSDictionaryOfVariableBindings(seg, label, topLayoutGuide) ) ; 


获取 解决 方案 代码 


访问 https://github.com/erica/iOS-7-Cookbook 网 页 ， 并 打开 “C07View Controllers ”文件 夹 ， 即 可 找到 与 本 章 中 的 解决 方案 相对 应 的 完整 范例 项 目 。 


7.4 解决 方案 : 模仿 界面 


在 使 用 一 般 的 导航 控制 器 上 时， 用户 会 逐次 深入 每 一 个 视图 ， 偶 尔 还 会 停 下 来 返回 前 一 个 视图 看 看 。 如 果 用 户 要 浏览 的 数据 与 树 状 的 视图 结构 相 匹 配 ， 那 么 这 种 办 
法 残 比较 合适 。 此 外 ， 我 们 还 可 以 用 模 态 的 方式 来 显示 视图 控制 器 。 


如 果 给 视图 控制 器 友 送 presentViewController: animated: completion: 消息 ， 那 么 该 消息 里 所 指定 的 那个 视图 控制 器 就 会 出 现在 屏幕 上 ， 并 取得 应 用 程序 的 
控制 权 ， 直 到 我 们 用 dismissViewControllerAnimated: completion: 令 其 消失 为 止 。 通 过 这 种 做 法 ， 可 以 为 应 用 程序 创建 一 种 不 同 于 alert view (= 
图 ，UIAlertView) 的 专用 对 话 框 。 


一 般 情 况 下 ， 我 们 会 用 模 态 控制 器 来 提示 用 户 选 择 某 种 数据 ， 比 如 Contacts 程 序 会 提示 用 户 选择 联系 人 ，Photos 程 序 会 提示 用 户 选择 照片 等 ， 另 外 还 会 用 模 态 控 
制 器 执行 一 些 短 时 间 的 任务 ,例如 友 送 电子 邮件 或 调整 程序 的 配置 选项 等 。 如 果 要 执行 一 种 与 当前 视图 控制 器 的 通常 职责 不 同 的 短期 任务 ， 那 么 可 以 考虑 使 用 模 态 控 


我 们 可 以 用 下 面 几 种 方式 切换 到 模 态 界面 

-Slide (tA) 一 一 在 原 有 视图 上 面 滑 入 新 的 视图 。 

- Flip (翻转) 一 一 令 原 有 视图 翻转 到 背面 ， 以 显示 新 的 视图 。 
Fade (RA) 一 一 令 新 的 视图 逐渐 浮现 在 原 有 视图 之 上 。 
-Curl (E). 一 一 主 视图 向 上 卷 起 ， 露 出 下 面 的 新 视图 。 


在 传 给 presentViewController: animated: completion: 方法 的 那个 视图 控制 器 上 面 设置 modalTransitionStyle 属 性 ， 即 可 指定 切换 方式 。 标 准 的 切换 方式 是 
UlIModalTransitionStyleCoverVertical， 也 就 是 把 模仿 视图 从 屏幕 底部 向 上 滑 入 到 现 有 的 视图 控制 器 上 方 。 等 它 要 消失 的 时 候 ， 会 向 下 滑 出 屏幕 。 


UIModalTransitionstyleFlipHorizontal 会 从 右 向 左 翻转 当前 的 视图 ， 使 得 用 户 可 以 看 到 它 背 后 的 模 态 视图 。 等 模 态 视图 要 消失 的 时 候 ， 又 会 从 左 向 右 翻 转 回去 。 
UIModalTransitionSstyleCrossDissolve 会 令 新 视图 以 淡 入 的 形式 出 现在 原 有 视图 上 方 。 等 到 消失 的 时 候 ， 逐渐 淡出 ， 以 便 露出 原来 的 视图 。 
UIModalTransitionstylePartialCurl 会 把 现 有 的 内 容 向 上 卷 起 来 (与 Maps 应 用 程序 的 做 法 相似 ) ， 并 露出 主 视 图 控制 器 下 方 的 模 态 设置 界面 。 


在 iPhone 和 iPod touch 上 面 ， 模 态 视图 控制 器 总 会 占 满 整个 屏幕 。iPad 则 提供 了 更 为 细致 的 展示 方式 。iPad 提 供 了 五 种 展示 风格 ， 我 们 可 以 通过 
modalPresentationStyle 属 性 来 设置 : 


- Full screen (全 屏 ) 一 一 这 是 iPhone 默 认 的 全 屏 展 示 风 格 (UIModalPresentation-FullScreen) ， 它 会 令 新 的 模 态 视图 占 满 整 个 屏幕 ， 并 替 盖 在 原 有 内 容 之 上 。 如 果 
modalTransitionStyle 设 为 UIModalTransitionStylePartial-Curl|， 那 么 modalPresentationStyle 只 能 选择 UIModalPresentationFull-Scteen， 如 果 选 了 其 他 展示 风格 ， 那 么 程序 会 因为 


运行 时 异常 (runtime exception) "n Af 9e 


: Page sheet (页 面 ) 如 果 以 页 面 风 格 (UIModalPresentationPageSheet) 来 展示 ， 那 么 模 态 视图 会 按照 竖 屏 状态 下 的 宽 高 比 来 显示 ， 所 以 ， 在 设备 处 于 坚 屏 状 
态 时 ， 模 态 视图 控制 器 会 填 满 整个 屏幕 ， 而 当 设 备 处 于 横 屏 状态 时 ， 则 只 会 覆盖 部 分 屏幕 ， 就 好 比 一 张 竖 着 的 纸 放 到 横着 的 屏幕 里 一 样 。 


- Form sheet (表单 ) 
模 态 视图 中 的 控件 时 ， 还 能 尽量 看 到 程序 主 视图 里 的 内 容 。 


如 果 以 表单 风格 (UIModalPresentationFormSheet) 来 展示 ， 那 么 模 态 视图 只 会 履 盖 屏幕 中 间 的 一 小 部 分 区 域 ， 这 样 的 话 ， 用 户 在 操作 


: Current context (当前 上 下 文 ) 一 一 UIModalPresentationCurrentContext 会 把 父 视图 控制 器 的 modalPresentationStyle 用 作 当 前 视图 的 展示 风格 。 


: Custom ( 自 定义 ) iOS 7 添加 了 Custom Transitions API， 用 于 管理 这 种 自 定义 的 展示 风格 (UIModalPresentationCustom) o 


这 些 展示 风格 在 横 屏 模式 下 的 效果 会 好 一 些 ， 因 为 此 时 能 够 体现 出 页 面 式 的 风格 与 全 屏风 格 之 间 的 区 别 。 


Qs iDOS7 引 入 了 一 种 模型 ， 能 够 在 视图 控制 器 之 间 创 建 自 定 义 的 切换 效果 (custom transition) ， 这 些 效果 可 以 增强 系统 所 提供 的 那些 内 置 效果 。 自 定义 的 切 
换 效 果 提 供 了 近乎 无 穷 的 灵活 度 ， 它 可 以 在 视图 控制 器 之 间 发 生 切 换 的 时 候 创建 出 新 颖 的 动画 效果 。 展 示 模 态 界 面 以 及 向 导航 控制 器 的 栈 里 推 入 新 视图 时 ， 也 可 以 使 
用 自 定义 的 切换 效果 。 


展示 目 定 义 的 模 态 信息 视图 


把 模 态 的 视图 控制 器 展示 出 来 之 后 ， 程 序 的 主导 航路 径 上 面 束 会 出 现 分 支 ， 这 个 模仿 的 新 界面 会 获得 应 用 程序 的 控制 权 ， 直 到 用 户 将 其 关闭 为 止 。 下 面 这 行 语句 


可 用 来 展示 模 态 控制 器 : 
[self presentViewController:someControllerInstance animated:YES completion:nil]; 


展示 出 来 的 控制 器 可 以 是 任意 UIViewController 子 类 的 实例 。 假 如 它 是 个 导航 控制 器 ， 那 么 这 个 模仿 界面 还 可 以 随 着 用 户 的 一 系列 操作 而 构建 出 自己 的 导航 结 
构 。 开 友 者 可 以 在 完成 块 (completion block) 里 面 编写 一 些 执行 任务 的 代码 ， 这 些 代码 会 在 视图 控制 器 以 动画 方式 展示 出 来 之 后 运行 。 


我 们 应 该 给 用 户 提供 某 种 形式 的 Done 按 钮 ， 使 其 可 以 关闭 模 态 控制 器 。 最 简单 的 办 法 是 展示 一 个 导航 控制 器 ， 并 给 它 的 navigationltem 上 面 添加 一 个 含有 相关 动 
作 的 UIBarButtonltem : 


- (IBAction) done: (id)sender 


[self dismissViewControllerAnimated:YES completion:nil]; 


故事 板 简 化 了 创建 模 态 控制 器 元 件 的 过 程 。 我 们 可 以 向 其 中 拖 放 一 个 导航 控制 器 实例 ， 这 样 会 把 配套 的 视图 控制 器 也 拖 放 进 去 ， 然 后 在 提供 好 的 导航 栏 上 面 添加 
Done 按 钮 。 把 视图 控制 器 的 类 (class) 设 为 开发 者 自 定义 的 模 态 控制 器 类 型 ， 并 把 Done 按 钮 连接 到 done: 方法 上 面 。 接 着 在 Attributes Inspector 中 给 导航 控制 器 
起 个 名 字 ， 以 便 在 代码 里 使 用 这 个 标识 符 来 加 载 它 。 


我 们 可 以 把 模 态 组 件 添加 到 主 故 事 板 里 ， 也 可 以 将 其 创建 到 一 份 单独 的 文件 中 。 解 决 方案 7-2 是 从 一 份 自 定 义 的 故事 板 文 件 (Modal~ DeviceType.storyboard,， 
其 中 DeviceType 表 示 设 备 类 型 ) 中 加 载 资源 的 ， 不 过 你 也 可 以 把 那些 元 件 放 到 MainStory-board_DeviceType 文 件 中 。 


解决 方案 7-2 提 供 了 创建 模 态 元 件 的 关键 代码 。 我 们 在 应 用 程序 的 主 视图 控制 器 层级 中 展示 模仿 界面 。 这 个 范例 程序 使 得 用 户 能 够 从 分 段 选择 控件 (segmented 
control) 中 选取 切换 方式 及 展示 方式 ， 不 过 在 其 他 应 用 程序 里 ， 这 两 个 选项 一 般 都 是 由 开发 者 预先 选 好 并 通过 代码 或 1B 来 设置 的 。 这 条 解决 方案 相当 于 一 个 工具 箱 ， 
开 友 者 可 以 在 各 个 平台 上 面 以 不 同 的 屏幕 方向 来 测试 每 一 种 选项 的 效果 。 


Qi 在 iOS 7 刚 发 布 的 时 候 ， 很 多 人 都 发 现 全 屏 状 态 下 的 翻转 切换 方式 有 问题 ， 解 决 方案 7-2 可 以 重 现 这 个 问题 。 我 们 会 发 现 ， 在 播放 动画 的 过 程 中 ， 时 航 栏 
里 的 那些 内 容 的 位 置 并 没有 随 着 动画 效果 而 改变 ， 但 是 等 动画 播放 完毕 后 ， 它 们 却 会 突然 从 上 面 掉 下 来 。 和 希望 苹果 公司 在 发 行 新 版 iDS 时 ， 能 解决 此 问题 。 


解决 方案 7-2 ”模仿 控制 器 的 展示 与 消失 


// Presenting the controller 
- (void)action: (id) sender 


{ 


// Load info controller from storyboard 


UIStoryboard *storyBoard = [UIStoryboard 
storyboardWithName: 
(IS IPAD ? @"Modal~iPad" : @"Modal~iPhone") 
bundle: [NSBundle mainBundle]]; 
UINavigationController *navController = 
[storyBoard instantiateViewControllerWithIdentifier: 
@"infoNavigationController"]; 


// Select the transition style 

int styleSegment = 
[segmentedControl selectedSegment Index] ; 

int transitionStyles[4] = { 
UIModalTransitionStyleCoverVertical, 
UIModalTransitionStyleCrossDissolve, 
UIModalTransitionStyleFlipHorizontal, 
UIModalTransitionStylePartialCurl]; 

navController.modalTransitionStyle - 
transitionStyles[styleSegment]; 


// Select the presentation style for iPad only 
if (IS IPAD) 


| 


int presentationSegment - 
[iPadStyleControl selectedSegment Index] ; 
int presentationStyles[3] = { 
UIModalPresentationFullScreen, 
UIModalPresentationPageSheet, 
UIModalPresentationFormSheet } ; 


if (navController.modalTransitionStyle == 
UIModalTransitionStylePartialCurl) 


// Partial curl with any non-full-screen presentation 

// raises an exception 

navController.modalPresentationStyle - 
UIModalPresentationFullScreen; 

[iPadStyleControl setSelectedSegmentIndex:0]; 


| 


else 
navController.modalPresentationStyle - 


presentationStyles [presentationSegment] ; 


[self .navigationController presentViewController:navController 
animated: YES completion:nil] ; 


- (void) loadView 


| 


self.view = [[UIView alloc] init]; 


self.view.backgroundColor - [UIColor whiteColor]; 
self.navigationItem.rightBarButtonItem = 
BARBUTTON(G"Action", Gselector(action:)); 


segmentedControl - 
[[UISegmentedControl alloc] initWithItems: 
[@"Slide Fade Flip Curl" 
componentsSeparatedByString:G" "]]; 
[segmentedControl setSelectedSegmentIndex:0]; 
self.navigationItem.titleView - segmentedControl; 


if (IS IPAD) 
| 
NSArray *presentationChoices - 
[NSArray arrayWithObjects:G"Full Screen", 
@"Page Sheet", @"Form Sheet", nil]; 
iPadStyleControl - 
[[UISegmentedControl alloc] initWithItems: 
presentationChoices]; 
[iPadStyleControl setSelectedSegmentIndex:0]; 
[self.view addSubview:iPadStyleControl]; 
PREPCONSTRAINTS (iPadStyleControl); 
CENTER VIEW H(self.view, iPadStyleControl); 
id topLayoutGuide - self.topLayoutGuide; 
CONSTRAIN VIEWS (self.view, 
@"V: [topLayoutGuide] - [iPadStyleControl]", 
NSDictionaryOfVariableBindings (topLayoutGuide, 
iPadStyleControl)); 


7.5 解决 方案 : 构建 分 栏 视图 控制 器 


分 栏 视图 控制 器 (split view controller) 很 适合 用 来 在 iPad 上 面 展示 有 层次 的 导航 界面 。 这 种 控制 器 通常 由 左 侧 的 目录 和 右 侧 的 细节 视图 组 成 ， 但 是 该 类 并 不 局 
限于 这 种 展示 方式 (而且 苹果 公司 的 设计 指南 也 没有 强 令 开发 者 必须 采用 这 种 展示 方式 ) 。 这 个 类 的 核心 概念 就 是 它 左 侧 的 组 织 区 域 (organizing section， 也 叫 
master， 主 视图 ) 以 及 右 侧 的 展示 区 域 (presentation section， 也 叫 detail， 细 节 视 图 ) ， 在 横 屏 模 式 下 ， 这 两 部 分 会 同时 出 现在 屏幕 上 ， 而 在 竖 屏 模式 下 ， 组 织 区 
域 则 可 以 通过 popover 的 形式 弹出 来 。 (我 们 可 以 在 delegate 中 实现 splitViewController: shouldHideViewController: inOrientation: 方法 ， 以 便 修改 这 种 默认 的 
行为 ， 使 得 分 栏 视图 的 左右 两 个 部 分 都 能 在 竖 屏 状态 下 显示 出 来 。) 


解决 方案 7-3 创 建 了 一 种 非 单 简单 的 分 柱 视 图 控制 器 ， 图 7-3 演 示 了 此 控制 器 在 横 屏 (AEWRE) FER ( 右 侧 截 图 ) 状态 下 的 效果 。 用 户 需 要 在 根 视图 的 列表 中 
选取 一 种 颜色 ， 然 后 控制 器 会 把 细节 视图 泻 染 成 该 颜色 。 在 横 屏 状态 下 ， 左 右 两 个 视图 会 同时 显示 出 来 ， 而 在 坚 屏 状态 下 ， 用 户 必 须 点 击 细节 视图 左上 和 角 的 按钮 ， 才 
能 看 到 以 popover 形 式 弹 出 来 的 根 视图 。 另 外 ， 用 户 也 可 以 通过 滑动 手势 把 这 个 视图 显示 出 来 ， 对 于 竖 屏 模式 来 说 ， 由 于 popover 显 示 在 细节 视图 的 前 方 ， 所 以 它 可 能 
会 干扰 到 细节 视图 。 开 发 者 应 该 对 此 做 出 相应 的 设计 .。 
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图 7-3 ”最 简单 的 分 栏 视图 控制 器 由 左 侧 的 组 织 面板 和 右 侧 的 细节 视图 面板 组 成 。 图 中 看 到 的 这 个 组 织 面板 在 竖 屏 模式 下 (4M RA) 通常 是 隐藏 起 来 的 。 用 户 点 击 导 
航 栏 上 的 按钮 之 后 ， 它 会 以 popover 的 形式 弹出 来 ， 此 外 ， 也 可 以 用 滑动 手势 把 它 显 示 出 来 


解决 方案 7-3 的 代码 构建 了 三 个 不 同 的 对 象 : 主 视图 控制 器 、 细 节 视 图 控制 器 以 及 分 栏 视图 控制 器 ， 后 者 会 拥有 前 两 者 。 分 栏 视图 控制 器 轧 是 包含 两 个 子 控制 器 ， 
也 融 是 下 标 为 0 的 主 视图 控制 器 和 下 标 为 1 的 细节 视图 控制 器 。 


为 了 设计 出 风格 一 致 的 界面 ， 我 们 应 该 把 主 视图 控制 器 和 细节 视图 控制 器 分 别 谋 套 在 各 自 的 导航 控制 器 里 。 对 于 细节 控制 器 来 说 ， 这 样 做 可 以 在 竖 屏 模式 下 把 按 
钮 显示 在 导航 栏 中 。 下 面 这 个 方法 创建 了 两 个 子 视图 控制 器 ， 并 把 它们 分 别 庶 套 在 各 自 的 导航 控制 器 里 ， 然 后 ， 用 包含 这 两 个 导航 控制 器 的 数组 来 配置 新 创建 的 
UlSplitViewController 对 象 ， 最后， 把 创建 好 的 分 栏 视图 控制 器 返回 给 调用 者 : 


- (UISplitViewController *)splitViewController 
{ 
// Create the navigation-embedded root (master) view 
ColorTableViewController *rootVC - 
[[ColorTableViewController alloc] init]; 
rootVC.title - G"Colors"; // make sure to set the title 
UINavigationController *rootNav - 
[[UINavigationController alloc] 
initWithRootViewController:rootVC]; 


// Create the navigation-run detail view 

DetailViewController *detailVC - 
[DetailViewController controller]; 

UINavigationController *detailNav = 


[[UINavigationController alloc] 
initWithRootViewController:detailVC]; 


// Add both to the split view controller 
UISplitViewController *svc - 

[[UISplitViewController alloc] init]; 
svc.viewControllers = @[rootNav, detailNav]; 
svc.delegate - detailVC; 


return svc; 


主 视 图 控制 器 一 般 是 某 种 形式 的 表格 视图 控制 器 ， 比 方 说 ， 解 决 方案 7-3 融 是 如 此 。 这 个 解决 方案 里 的 主 视图 控制 器 和 一 张 简 单 的 表格 差不多 。 表 格 里 面 列 出 了 各 
种 颜色 (实际 上 束 是 UIColor 的 各 种 方法 名 ) ， 每 个 单元 格 的 标题 都 是 一 种 头 色 的 名 字 ， 用 户 点 击 单元 格 之 后 ， 石 边 的 细节 视图 就 会 变 成 对 应 的 颜色 。 


用 户 选 中 某 颜色 时 ， 控 制 器 会 使 用 内 置 的 splitViewController 属 性 向 细节 视图 友 送 请 求 。 该 属性 指 的 束 是 包含 根 视 图 的 分 栏 视 图 控制 器 。 根 视图 可 以 获取 分 栏 视 
图 的 delegate (Ait) ， 这 个 delegate 指 向 细节 视图 。 我 们 把 delegate 的 类 型 转换 成 细节 视图 控制 器 的 类 型 ， 以 便 使 根 视图 能 够 更 为 精细 地 控制 细节 视图 。 这 个 极为 
简单 的 学 例 程序 会 把 用 户 所 选单 元 格 的 文本 设 为 细节 视图 的 背景 色 。 


Qi 请 务必 设置 好 根 视 图 控制 器 的 title 属 性 。 因 为 在 竖 屏 模式 下 ， 该 属性 的 文本 要 出 现在 细节 视图 的 按钮 里 。 


解决 方案 7-3 的 DetailViewController 类 可 以 看 作 一 份 代码 模板 。 它 实现 了 一 个 具备 基本 功能 的 细节 视图 控制 器 ， 我 们 可 以 将 这 个 控制 器 集成 到 分 栏 视图 控制 器 之 
中 。 该 类 还 实现 了 一 对 名 叫 splitViewController: willHideViewController: withBarButtonltem: forPopoverController: 及 splitViewController: 
willshowViewController: invalidatingBarButtonltem: 的 方法 ， 并 在 其 中 分 别 为 细节 视图 添加 及 移 除了 重要 的 UIBarButtonltem。 


解决 方案 7-3 ”构建 分 枉 视 图 控制 器 的 细节 视图 及 主 视图 


@interface DetailViewController : UIViewController 
«UIPopoverControllerDelegate, UISplitViewControllerDelegate> 

@property (nonatomic, strong) 
UIPopoverController *popoverController; 

@end 

@implementation DetailViewController 

+ (instancetype) controller 

{ 
DetailViewController *controller = 

[[DetailViewController alloc] init]; 

controller.view.backgroundColor = [UIColor blackColor] ; 


return controller; 


// Called upon going into portrait mode, hiding the normal table view 

- (void)splitViewController: (UISplitViewController*)svc 
willHideViewController: (UIViewController *)aViewController 
withBarButtonItem: (UIBarButtonItem*) barButtonItem 
forPopoverController: (UIPopoverController*)aPopoverController 


barButtonItem.title = aViewController.title; 
self .navigationItem.leftBarButtonItem = barButtonItem; 
self.popoverController = aPopoverController; 


// Called upon going into landscape mode 

- (void)splitViewController: (UISplitViewController*) svc 
willShowViewController: (UIViewController *)aViewController 
invalidatingBarButtonItem: (UIBarButtonItem *)barButtonItem 


self.navigationItem.leftBarButtonItem - nil; 
self.popoverController - nil; 


// Use this to avoid the popover hiding in portrait. 

// When omitted, you get the default behavior. 

/* - (BOOL)splitViewController: (UISplitViewController *)svc 
shouldHideViewController: (UIViewController *)vc 
inOrientation: (UIInterfaceOrientation)orientation 


return NO; 
rey. 
@end 


@interface ColorTableViewController : UITableViewController 
@end 


@implementation ColorTableViewController 
+ (instancetype) controller 
{ 
ColorTableViewController *controller = 
[[ColorTableViewController alloc] init]; 
controller.title = @"Colors"; 
return controller; 


(NSInteger) numberOfSectionsInTableView: (UITableView *)tableView 


return i; 


- (NSArray *)selectors 


return @[@"blackColor", @"redColor", @"greenColor", @"blueColor", 
@"cyanColor", @"yellowColor", @"magentaColor", @"orangeColor", 
@"purpleColor", @"brownColor"] ; 


(NSInteger) tableView: (UITableView *)tableView 
numberOfRowsInSection: (NSInteger) section 


return [self selectors] .count; 


- (UITableViewCell *)tableView: (UITableView *)tableView 
cellForRowAtIndexPath: (NSIndexPath *)indexPath 


UITableViewCell *cell - 
[tableView dequeueReusableCellWithIdentifier:@"generic"] ; 
if (!cell) cell = [[UITableViewCell alloc] 
initWithStyle: UITableViewCellStyleDefault 
reuseldentifier:@"generic"] ; 


// Set title and color 
NSString *item = [self selectors] [indexPath. row] ; 
cell.textLabel.text = item; 
cell.textLabel.textColor = 
[UIColor performSelector:NSSelectorFromString (item) 
withObject:nil]; 


return cell; 


- (void)tableView: (UITableView *)tableView 
didSelectRowAtIndexPath: (NSIndexPath *)indexPath 


// On selection, update the main view background color 
UINavigationController *nav - 
[self.splitViewController.viewControllers lastObject]; 
UIViewController *controller = [nav topViewController] ; 
UITableViewCell *cell = [tableView cellForRowAtIndexPath:indexPath]; 
controller.view.backgroundColor = cell.textLabel.textColor; 


| 


@end 


程序 切换 到 竖 屏 状态 时 ， 分 栏 视图 控制 器 会 把 主 视图 控制 器 转换 成 UIPopover-Controller， 并 把 这 个 新 的 UIPopoverController 传 给 细节 视图 控制 器 。 细 节 视 图 
控制 器 则 要 负责 保留 并 处 理 这 个 popover， 直 到 界面 恢复 横 屏 状态 为 止 。 在 这 份 模 板式 的 类 代码 中 ， 我 们 定义 了 一 个 强 (strong) 属性 ， 用 来 保留 竖 屏 状态 下 的 
popover， 使 得 用 户 可 以 操作 它 。 


7.6 解决 万 案 : 用 分 栏 视 图 及 导航 控制 器 创建 通用 的 程序 
解决 方案 7-4 修 改 了 解决 方案 7-3 的 分 栏 视图 控制 路， 使 程序 可 以 同时 适用 于 iphone 及 ipad 平 台 ， 而 且 令 用 户 能 够 在 这 两 个 版 本 中 执行 等 效 的 操作 。 为 了 实现 这 一 


目标 ， 我 们 需要 以 解决 方案 7-3 的 代码 为 基础 再 添加 一 些 步 又。 分 枉 视 图 控制 器 里 已 有 的 那些 功能 无 须 移 除 ， 但 是 必须 在 好 几 个 地 方 采 用 两 套 做 法 才 行 。 


解决 方案 7-4 用 安 来 判断 代码 是 运行 在 iPad 还 是 iPhone 系列 的 设备 上 面 。 它 利用 UIKit 的 user interface idiom (用 户 界 面 风格 ) 来 实现 这 个 判断 : 


Hdefine IS IPAD (UI USER INTERFACE IDIOM() == UIUserInterfaceIdiomPad) 


如 果 设 备 特征 与 ijPad 系 列 相 符 但 与 iPhone 系列 (例如 iPhone 或 iPod touch) 不 同 ， 那 么 上 述 宏 就 返回 YES。 苹 果 公 司 在 iOS 3.2 里 首次 将 iPad 定 为 新 的 硬件 平 
台 ， 在 代码 里 判断 user interface idiom ， 就 能 令 程序 在 运行 的 时 候 可 以 根据 部 署 到 的 硬件 平台 来 提供 适当 的 界面 。 


开发 iPhone 版 本 的 程序 时 ， 解 决 方案 7-3 里 细节 视图 控制 器 的 代码 依然 保持 不 变 ， 但 在 显示 的 时 人 息 ， 则 需 将 其 推 入 导航 栈 ， 而 不 是 像 iPad 上 面 的 分 栏 视 图 那样 ， 
把 细节 视图 与 主 视 图 并 排放 置 。 所 以 ， 此 时 要 把 导 舰 控制 器 设 为 应 用 程序 视窗 的 主 视图 控制 器 ， 而 不 是 分 枉 视 图 的 子 控制 器 。 程 序 局 动 时 ， 只 需 执行 一 段 简单 的 检测 
代码 ， 融 能 判断 出 具体 应 该 使 用 哪 种 办 法 了 : 


(UINavigationController *)navWithColorTableViewController 


ColorTableViewController *rootVC - 
[[(ColorTableViewController alloc) init]; 

rootVC.title - e"Colors"; 

UINavigationController *nav - [[UINavigationController alloc] 
initWithRootViewController:rootVC]; 

return nav; 


(BOOL)application: (UIApplication *)application 
didFinishLaunchingWithOptions: (NSDictionary *)launchOptions 


window = [[UIWindow alloc] initWithFrame: 
[[UIScreen mainScreen] bounds]]; 


UIViewController * rootVC - nil; 
if (IS IPAD) 
rootVC = [self splitViewController]; 
else 
rootVC = [self navWithColorTableViewController]; 


rootVC.edgesForExtendedLayout = UIRectEdgeNone; 
window. rootViewController = rootVC; 

[window makeKeyAndVisible]; 

return YES; 


解决 方案 7-4 还 需要 在 选取 颜色 所 用 的 那个 表格 视图 控制 器 里 修改 两 个 方法 。 我 们 要 做 两 次 天 键 的 判断 ， 以 决定 是 否 显 示 Disclosure Indicator (扩展 指示 器 ) 
案 以 及 如 何 应 对 用 户 对 表格 的 点 击 : 


解决 方案 7-4 ”用 两 种 方式 来 实现 分 栏 视图 的 效果 ， 以 便 制作 出 通用 的 应 用 程序 


- (UITableViewCell *)tableView: (UITableView *)tableView 
cellForRowAtIndexPath: (NSIndexPath *)indexPath 


UITableViewCell *cell - 
[tableView dequeueReusableCellWithIdentifier:@"generic"] ; 
if (!cell) cell = [[UITableViewCell alloc] 
initWithStyle:UITableViewCellStyleDefault 
reuseldentifier:@"generic"] ; 
NSString *item = [self selectors] [indexPath.row]; 
cell.textLabel.text = item; 
cell.textLabel.textColor = 
[UIColor performSelector:NSSelectorFromString (item) 
withObject:nil]; 


cell.accessoryType - IS IPAD ? 
UITableViewCellAccessoryNone 
UITableViewCellAccessoryDisclosureIndicator; 


return cell; 


- (void)tableView: (UITableView *)tableView 
didSelectRowAtIndexPath: (NSIndexPath *)indexPath 


UITableViewCell *cell - 
[tableView cellForRowAtIndexPath:indexPath]; 


if (IS IPAD) 
UINavigationController *nav - 
[self.splitViewController.viewControllers lastObject]; 
UIViewController *controller - [nav topViewController]; 
controller.view.backgroundColor = cell.textLabel.textColor; 


} 


else 


( 


DetailViewController *controller = 

[DetailViewController controller]; 
controller.view.backgroundColor = cell.textLabel.textColor; 
controller.title - cell.textLabel.text; 


[self.navigationController 
pushViewController:controller animated:YES]; 


: 在 iPad 上 面 ， 当 程序 到 达 最 后 一 层 细 节 界 面 的 时 候 ， 不 应 该 显示 Disclosutre Indicatot 图 标 。 而 在 iPhone 上 面 ， 则 需要 用 这 种 图 人 案 提 示 用 户 选择 该 单元 格 之 后 ， 会 有 
新 的 视图 弹出 来 。 我 们 在 代码 中 根据 程序 所 部 署 到 的 平台 来 决定 是 否 为 单元 格 添加 此 图 案 。 


: 由 于 iPhone 平台 不 能 使 用 分 栏 视图 控件 ， 所 以 我 们 必须 把 新 的 细节 视图 推 入 导航 控制 器 的 栈 中 。 而 iPad 平 台 则 不 然 ， 它 可 以 直接 获取 现 有 的 细节 视图 ， 并 更 新 其 


背景 色 。 


在 日 常 开 友 中 ， 这 两 个 地 方 需要 检测 的 内 容 也 许 会 更 加 复杂 ， 而 不 会 像 本 例 这 样 只 需 处 理 一 下 细节 视图 就 行 了 。 开 友 者 可 能 还 得 在 模型 里 面 做 检测 ， 以 判断 当前 
是 不 是 真 到 了 树 状 结构 的 最 底层 ， 并 据 此 决定 是 否 隐藏 Disclosure Indicator 图 案 。 还 有 就 是 ， 我 们 可 能 需要 更 新 或 替换 细节 视图 控制 器 中 的 界面 。 


7.7 RDR: ISH 


iPhone 和 iPod touch 都 可 以 使 用 UITabBarController 类 ， 令 用 户 能 够 在 多 个 视图 控制 器 之 间 切 换 ， 并 且 能 够 定制 屏幕 帮 部 的 标签 栏 。 这 种 用 法 在 音乐 类 的 程序 里 
效果 最 好 。 用 户 只 需 点 击 一 下 屏幕 ， 束 能 切换 到 其 他 视图 ， 而 且 还 能 通过 More 按 钮 来 选择 并 编辑 需要 显示 在 屏幕 底部 标签 栏 里 的 标签 (Tab) 。 在 iPad 上 面 ， 不 应 该 
把 标签 栏 用 作 主 要 的 设计 风格 ， 不 过 苹果 公司 也 认为 ， 在 确 有 必要 时 可 以 一 用 ， 尤 其 是 在 分 栏 视图 及 popover 里 面 。 


使 用 标签 栏 的 时 候 ， 不 需要 像 使 用 导航 栏 那样 把 视图 推 入 栈 中 ， 而 是 需要 设置 view-Controllers 属 性 ， 以 便 将 一 系列 控制 器 (每 个 控制 器 可 以 分 别 是 
UIViewController、UINavigationController 或 其 他 类 型 的 控制 器 ) 添加 到 标签 栏 里 。Cocoa Touch 会 完成 剩 下 的 工作 。 如 果 把 allowsCustomizing 设 为 YES， 那 么 
用 户 就 能 够 重新 调整 各 个 标签 的 顺序 了 。 


解决 方案 7-5 创 建 了 11 个 简单 的 视图 控制 器 ， 它 们 都 是 BrightnessController 类 的 实例 。 该 类 会 把 背景 设 为 指定 的 灰 度 (gray level， 灰 阶 ) ， 在 本 例 中 ， 我 们 采用 
从 09% 到 100% 的 11 种 灰 度 ， 相 邻 两 种 灰 度 之 间 相 差 10%。 图 7-4 左 侧 截 图 演示 了 默认 模式 下 的 界面 ， 它 会 把 前 四 个 标签 显示 出 来 ， 而 且 还 会 显示 More 按 钮 。 


用 户 可 以 点 击 More 选 项 ， 然 后 点 击 Edit， 这 样 残 能 重新 排列 各 标签 的 次 序 了 。 此 时 屏幕 上 会 出 现 如 图 7-4 右 侧 截 图 所 示 的 配置 画面 。 里 面 有 11 个 视图 控制 器 ， 用 
户 可 以 浏览 并 选取 自己 所 需 的 那些 。 请 注意 ， 在 笔者 编写 本 书 时 所 用 的 iOS 7 系统 里 ， 图 7-4 右 侧 截 图 中 的 导航 栏 并 没有 变 成 'iOS 7 的 扁平 式 (flat) 标准 UI 风格 。 


在 整个 界面 中 ， 导 航 栏 半 透 明 背 景 的 tint color 都 是 黑色 。 苹 果 公 司 提供 了 UIAppearance 协 议 ， 使 开 友 者 可 以 修改 某 个 类 所 有 实例 的 UIl 属 性。 解决 方案 7-5 利 用 这 
一 特性 把 导航 栏 背景 的 tint color 设 为 黑色 : 


[[UINavigationBar appearance] setBarTintColor: [UIColor blackColor]]; 


Qi: WOS 7 开始 ， 栏 背景 (比如 导航 栏 背 景 ) 的 tint colot 不 再 用 tintColot 属 性 来 表示 。 如 果 想 设 定 背景 的 tint colot， 那 么 需要 使 用 batTintColor 属 性 。 


Carrier = 


图 7-4 标签 栏 控制 器 使 得 用 户 可 从 屏幕 底部 的 标签 栏 中 选择 所 需 的 视图 控制 器 〈 如 左 侧 截 图 所 示 ) ， 而 且 还 能 在 一 系列 可 用 的 控制 器 中 挑选 自己 喜欢 的 那些 ， 用 以 定 
制 标 签 栏 ( 如 右 侧 截图 所 示 ) 


这 条 解决 方案 把 11 个 控制 器 添加 了 两 遍 。 第 一 遍 是 把 它们 赋 给 用 户 可 以 使 用 的 视图 控制 器 列表 : 


tabBarController.viewControllers = controllers; 


第 二 遍 是 把 它们 赋 给 customizableViewControllers， 用 户 在 定制 屏幕 底部 的 标签 栏 时 ， 可 以 从 这 个 列表 所 包含 的 控制 器 里 选择 自己 喜欢 的 那些 : 


tabBarController.customizableViewControllers = controllers; 


二 行 代 码 是 可 选 的 ， 而 第 一 行 代码 则 必须 要 写 。 设 置 好 这 些 视图 控制 器 之 后 ， 可 以 把 它们 全 都 添加 到 可 供 配置 的 控制 器 列表 里 ， 也 可 以 只 添加 其 中 一 部 分 进 
去 。 如 果 不 添加 ， 那 么 用 户 点 击 More 按 钮 之 后 ， 仍 然 能 看 到 其 他 视图 控制 器 ， 但 他 们 无 法 将 自己 想 要 的 控制 器 扔 放 到 主 标 签 栏 中 。 


在 More 男 面 里 ,标签 的 图 案 会 以 反 色 效 果 显 示 。 根 据 苹 果 公 司 的 说 法 ， 这 种 效果 是 合理 的 。 苹 果 公 司 也 没 打 算 修 改 这 一 行为 。 于 是 我 们 可 以 看 到 一 种 有 趣 的 现 
Z: 100% 的 纯 黑 色 块 在 More 画 面 中 会 变 成 纯 日 。 此 外 ，iOS 7 在 演 染 图 标 和 文本 的 时 候 ， 会 把 从 应 用 程序 里 继承 下 来 的 tintColor 属 性 当成 这 些 物件 的 tint color, 


解决 方案 7-5 ”创建 标签 栏 视 图 控制 器 


#pragma mark - BrightnessController 
@interface BrightnessController : UIViewController 
Gend 


@implementation BrightnessController 


{ 


int brightness; 


// Create a swatch for the tab icon using standard Quartz 

// and UIKit image calls 

-~ (UIImage*) buildSwatch: (int) aBrightness 

{ 
CGRect rect = CGRectMake(0.0f, 0.0f, 30.0£, 30.0f); 
UIGraphicsBeginImageContext (rect.size) ; 
UIBezierPath *path = [UIBezierPath 

bezierPathWithRoundedRect:rect cornerRadius:4.0f]; 
[[[UIColor blackColor] 
colorWithAlphaComponent: (float) aBrightness / 10.0f] set]; 

[path fill]; 


UIImage *image = UIGraphicsGetImageFromCurrentImageContext () ; 
UIGraphicsEndImageContext () ; 


return image; 


// The view controller consists of a background color 
// and a tab bar item icon 
-(BrightnessController *)initWithBrightness: (int) aBrightness 
{ 
self = [super init]; 
brightness = aBrightness; 
self.title = [NSString stringWithFormat :@"%d%%", 
brightness * 10]; 
self.tabBarItem = 
[[UITabBarItem alloc] initWithTitle:self.title 
image: [self buildSwatch:brightness] tag:0]; 
self.view.autoresizesSubviews = YES; 
self.view.autoresizingMask = 
UIViewAutoresizingFlexibleWidth | 
UIViewAutoresizingFlexibleHeight ; 
return self; 


// Tint the background 
- (void) loadView 


| 


self.view - [[UIView alloc] initl; 


self.view.backgroundColor - 
[UIColor colorWithWhite: (brightness / 10.0f) alpha:1.0f]; 


+ (id)controllerWithBrightness: (int)brightness 
( 


BrightnessController *controller - 
[[BrightnessController alloc] 
initWithBrightness:brightness]; 
return controller; 


| 


end 


#pragma mark - Application Setup 

@interface TestBedAppDelegate : NSObject 
«UIApplicationDelegate, UITabBarControllerDelegate» 

@property (nonatomic, strong) UIWindow *window; 

@end 


@implementation TestBedAppDelegate 


| 


UITabBarController *tabBarController; 


- (void)applicationDidFinishLaunching: (UIApplication *)application 
{ 
// Globally use a black tint for nav bars 
[[UINavigationBar appearance] 
setBarTintColor: [UIColor blackColor]]; 


// Build an array of controllers 
NSMutableArray *controllers = [NSMutableArray array] ; 
for (int i = 0; i «s 10; i++) 
{ 
BrightnessController *controller = 
[BrightnessController controllerWithBrightness:i]; 
UINavigationController *nav - 
[[UINavigationController alloc] 
initWithRootViewController:controller]; 
nav.navigationBar.barStyle = UIBarStyleBlackTranslucent; 
[controllers addObject:nav]; 


tabBarController = [[UITabBarController alloc] init]; 
tabBarController.tabBar.barTintColor = [UIColor blackColor]; 
tabBarController.tabBar.translucent = NO; 
tabBarController.viewControllers = controllers; 
tabBarController.customizableViewControllers = controllers; 
tabBarController.delegate = self; 


window = [[UIWindow alloc] 


initWithFrame: [[UIScreen mainScreen] bounds]]; 
 window.tintColor - COOKBOOK PURPLE COLOR; 
tabBarController.edgesForExtendedLayout - UIRectEdgeNone; 


 window.rootViewController - tabBarController; 
[ window makeKeyAndVisible]; 
return YES; 


| 


@end 


7.8 inten 


对 于 iOS 平 台 来 说 ， 持 久 是 金 (persistence is golden) 。 局 动 应 用 程序 或 者 从 暂停 及 中 断 状态 继续 执行 程序 的 时 候 ， 我 们 应 该 把 程序 状态 恢复 到 用 户 上 一 次 离开 
时 的 样子 。 这 样 做 使 得 用 尸 能 够 继续 操作 上 次 正在 操控 的 内 容 ， 并 且 能 令 用 户 界 面 与 上 次 会 话 的 界面 相符 。 程 序 清单 7-1 中 的 范例 代码 可 以 实现 这 个 功能 。 


程序 清单 7-1 把 标签 状态 保存 到 NSUserDefaults 中 


@implementation TestBedAppDelegate 


| 


UITabBarController *tabBarController; 


- (void)tabBarController: (UITabBarController *)tabBarController 
didEndCustomizingViewControllers: (NSArray *)viewControllers 
changed: (BOOL) changed 


// Collect and store the view controller order 

NSMutableArray *titles = [NSMutableArray array] ; 

for (UIViewController *vc in viewControllers) 
[titles addObject:vc.title]; 


[[NSUserDefaults standardUserDefaults] setObject:titles 
forKey:@"tabOrder"] ; 
[[NSUserDefaults standardUserDefaults] synchronize] ; 


- (void)tabBarController: (UITabBarController *)controller 
didSelectViewController: (UIViewController *)viewController 


// Store the selected tab 
NSNumber *tabNumber = 
[NSNumber numberWithInt: [controller selectedIndex]]; 
[[NSUserDefaults standardUserDefaults] 
setObject:tabNumber forKey:G"selectedTab"]; 
[[NSUserDefaults standardUserDefaults] synchronize]; 


(BOOL) application: (UIApplication *)application 
didFinishLaunchingWithOptions: (NSDictionary *) launchOptions 


// Globally use a black tint for nav bars 
([UINavigationBar appearance] 
setBarTintColor: [UIColor blackColor]]j; 


NSMutableArray *controllers = [NSMutableArray array] ; 
NSArray *titles = [[NSUserDefaults standardUserDefaults] 


objectForKey:@"tabOrder"] ; 


if (titles) 
{ 
// titles retrieved from user defaults 
for (NSString *theTitle in titles) 
{ 
BrightnessController *controller = 
[BrightnessController controllerWithBrightness: 
([theTitle intValue] / 10)]; 
UINavigationController *nav = 
[[UINavigationController alloc] 
initWithRootViewController:controller]; 


nav.navigationBar.barStyle - UIBarStyleBlackTranslucent; 
[controllers addObject:nav]; 


j 


else 
{ 
// generate all new controllers 
for (int i = 0; i <= 10; 1++) 
{ 
BrightnessController *controller = 
[BrightnessController controllerWithBrightness:1i]; 
UINavigationController *nav = 
[[UINavigationController alloc] 
initWithRootViewController:controller] ; 
nav.navigationBar.barStyle = UIBarStyleBlackTranslucent ; 
[controllers addObject:nav] ; 


| 


tabBarController = [[UITabBarController alloc] init]; 


tabBarController.tabBar.barTintColor = [UIColor blackColor]; 
tabBarController.tabBar.translucent = NO; 
tabBarController.viewControllers - controllers; 
tabBarController.customizableViewControllers = controllers; 


tabBarController.delegate - self; 


// Restore any previously selected tab 
NSNumber *tabNumber - [[NSUserDefaults standardUserDefaults] 


objectForKey:G"selectedTab"]; 


if (tabNumber) 
tabBarController.selectedIndex - [tabNumber intValue]; 


window - [[UIWindow alloc] 

initWithFrame:[[UIScreen mainScreen] bounds]]; 
_window.tintColor = COOKBOOK PURPLE COLOR; 
tabBarController.edgesForExtendedLayout = UIRectEdgeNone; 


_window.rootViewController = tabBarController; 
[ window makeKeyAndVisible] ; 
return YES; 


| 


@end 


它 修 改 了 解决 方案 7-5 中 的 代码 ， 以 便 把 当前 的 标 等 顺序 以 及 用 户 目 前 所 选 的 标签 保 他 起 来 ， 当 这 些 标签 有 变化 时 ， 它 也 会 执行 保存 操作 。 用 户 局 动 应 用 程序 之 
后 ， 这 段 代 码 会 搜寻 上 一 次 的 配置 ， 如 果 找 到 了 ， 残 据 此 配置 标 等 栏 。 


为 了 在 标签 发 生变 化 时 做 出 响应 ， 标 签 栏 的 delegate 必 须 宣称 自己 遵循 UITab-BarControllerDelegate 协 议 。 范 例 代码 用 到 了 协议 里 的 两 个 委托 方法 。 第 一 个 方 
法 是 tabBarController: didEndCustomizingViewControllers: changed: ， 当 用 户 通 过 More>Edit 画 面 把 标签 定制 好 之 后 ， 可 以 经 由 这 个 方法 所 提供 的 数组 来 获知 
当前 的 各 视图 控制 器 。 范 例 代码 会 获取 控制 器 的 标题 (也 就 是 10%、20% 等 文本 ) ， 并 且 用 这 个 信息 来 标识 每 个 视图 控制 器 的 身份 。 


第 二 个 委托 方法 叫 作 tabBarController: didSelectViewController: 。 用 户 选择 新 的 标签 时 ， 标 签 栏 控制 器 会 调用 这 个 方法 。 范 例 代 码 可 以 获取 到 selectedlndex 
的 值 ， 以 便 将 用 户 所 选 的 控制 器 在 当前 数组 内 的 序号 保存 起 来 。 


本 例 通 过 iOSs 内 置 的 用 户 默 认 值 系统 (user defaults system, NSUserDefaults) 来 存储 这 些 值 。 这 套 选 项 系统 的 工作 原理 很 像 一 个 大 型 可 变 字典 (mutable 
dictionary) , setObject: forKey: 方法 可 以 给 某 个 键 (key) 设置 相关 的 值 (value) : 


[[NSUserDefaults standardUserDefaults] setObject:titles 
forKey:G"tabOrder"]; 


稍 后 可 用 objectForKey: 方法 来 查询 刚才 设置 的 值 : 


NSArray *titles = [[NSUserDefaults standardUserDefaults] 
objectForKey:e"tabOrder"]; 


修改 完 之 后 ， 可 调用 synchronize 方 法 ， 把 数据 同步 到 NSUserDefaults 里 面 : 
[[NSUserDefaults standardUserDefaults] synchronize]; 


应 用 程序 启动 时 ， 会 寻找 上 一 次 的 配置 信息 ， 以 获取 用 户 所 定制 的 标签 顺序 以 及 所 选中 的 标签 序号 。 如 果 找 到 了 这 种 信息 ， 就 用 它们 来 配置 标签 栏 中 的 标签 ， 并 
把 上 次 选 定 的 那个 标签 激活 。 由 于 标题 里 包含 的 信息 是 亮度 值 ， 所 以 代码 要 把 上 次 保存 的 标题 从 文本 变 为 数字 ， 并 将 其 除 以 10， 然 后 发 送 给 BrightnessController 的 初 
始 化 方法 。 


大 部 分 应 用 程序 都 不 使 用 这 种 简单 的 数值 系统 。 如 果 要 用 标题 来 保 仓 标 答 栏 上 的 标签 顺序 ， 那 么 请 给 各 视图 控制 器 都 起 个 有 意义 的 名 称 ， 并 且 要 设计 出 一 种 方 
式 ， 以 便 在 排 好 顺序 的 一 系列 标签 中 找到 某 个 视图 控制 器 。 


Qaz 也 可 以 把 各 视图 的 标签 保存 到 NSNumbet 数 组 中 ， 或 是 采用 NSKeyedAtrchivet 类 来 实现 ， 那 样 效 果 会 更 好 。 通 过 NSKeyedArtrchivef 类 ， 我 们 可 以 在 程序 终止 
的 时 候 把 视图 的 状态 信息 保存 起 来 ， 以 便 下 次 启动 时 恢复 。 还 有 一 种 办 法 ， 就 是 使 用 由 iDOS 6 所 引入 的 状态 保留 系统 。 


7.9 RDR: 页 面 视 图 控制 器 


UlPageViewController 类 可 以 构建 出 一 种 类 似 书籍 的 界面 ， 并 且 分 别 用 多 个 视图 控制 器 来 表示 书 中 的 每 一 页 。 用 户 可 以 通过 滑动 手势 来 翻 页 ， 也 可 以 点 击 页 面 边 
缘 ， 将 书 翻 到 下 一 页 或 上 一 页 。 我 们 可 以 用 页 面 创建 出 类 似 书籍 的 版 式 (如 图 7-5 左 侧 截 图 所 示 ) ， 也 可 以 创建 一 种 平坦 的 滚动 界面 (如 图 7-5 右 侧 截 图 所 示 ) . ER 
动 式 的 界面 中 ， 视 图 底部 会 出 现 页 面 指示 器 (page indicator) 。 
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图 7-5  UlPageViewControllerA& 7K £ MILA ZH Belek — um dag "B^ . AP TMM ARABARAD (AMAA) ， 也 可 以 通过 滚动 来 查看 它 (AMM 
图 ) 


控制 器 的 页 面 既 可 以 像 图 7-5 这 样 都 以 一 种 方式 来 呈现 ， 也 可 以 拥有 各 自 独 特 的 用 户 操作 体验 。 在 UIPageViewController 类 中 ， 苹 果 公 司 把 播放 动画 效果 及 处 理 
手势 所 需 的 代码 全 都 预制 好 了 。 开 发 者 负责 提供 内 容 ， 并 实现 委托 方法 以 及 与 数据 源 有 关 的 回调 方法 。 


79.1 与 书籍 展示 风格 有 天 的 属性 


我 们 要 用 代码 来 定制 页 面 视图 控制 器 的 样 够 和 行为 。 其 中 有 一 些 关 键 属性 可 以 指定 多 个 页 面 同时 显示 时 的 方式 以 及 每 个 页 面 背 后 的 内 容 等 。 下 面 简单 介绍 一 下 由 
苹果 公司 所 提供 的 属性 : 


- transitionStyle 属 性 用 来 指定 两 个 视图 控制 器 之 间 的 切换 效果 。 笔 者 编写 本 书 时 ， 页 面 视图 控制 器 只 支持 翻 页 (UIPageViewControllerTransitionStyle-PageCutl， 如 图 
7-5 AM) AKA AR) 和 滚动 显示 (UIPageViewControllerTrans-itionStyleScroll) 两 种 风格 。 后 一 种 风格 是 在 iOS 6 里 引入 的 。 


: 控制 器 的 doubleSided 属 性 决定 了 内 容 是 出 现在 同一 页 的 正 反 两 面 ( 如 图 7-5 左 侧 截 图 所 示 ) ， 还 是 只 出 现在 其 中 一 面 〈 如 图 7-5 右 侧 截图 所 示 ) 。 假 如 要 并 排 显 示 
两 页 内 容 ， 那 么 就 应 该 开启 该 属性 。 否 则 ， 有 一 半 的 页 面 都 看 不 见 ， 因 为 页 面 的 “背面 ”无 法 出 现在 主 视图 空间 内 。 书 的 排版 由 书 瑚 位 置 来 控制 


: 通过 spineLocation 属 性 ， 可 以 把 书 背 设 置 到 屏幕 左右 两 侧 、 上 下 两 端 或 页 面 正 中 。 三 个 相关 的 常数 值 分 别 是 UIPageViewConttollefSpineLocationMin (对 应 于 顶端 或 
EA) ~ UlPageViewControllerSpineLocationMax (对 应 于 底 端 或 右 侧 ) BUIPageViewControllerSpineLocationMid (对 应 于 中 心 ) 。 前 两 种 常量 会 产生 单 页 展示 风格 ， 后 一 
种 (也 就 是 书 关 在 中 间 的 那 种 ) 用 来 同时 显示 两 页 内 容 。 设 备 方 向 改变 时 ， 系 统 会 调用 名 为 pageViewConttollef: spineLocation-ForInterfaceOrientation: 的 委托 方法 ， 开 
发 者 应 该 在 该 方法 中 返回 所 选 的 spineLocation 属 性 ， 令 控制 器 可 以 根据 当前 设备 方向 来 更 新 其 视图 。 


navigationOtrientation 属 性 用 来 指定 这 本 书 是 左右 翻 页 还 是 上 下 翻 页 。UIPageView-ControllerNavigationOrientationHorizontal 表 示 左 右 翻 页 UIPageView- 
ControllerNavigationOtrientationVertical 表 示 上 下 翻 页 。 对 于 上 下 翻 页 的 书 来 说 ， 页 面 应 该 是 上 下 翻动 的 ， 而 不 是 像 平常 那样 左右 翻动 。 


79.2 HALMA 


页 面 视 图 控制 器 与 表格 视图 相同 的 地 方 在 于 ， 二 者 都 需要 用 委托 和 数据 源 来 设 定 其 行为 以 及 所 要 展示 的 内 容 。 但 与 表格 视图 不 同 的 是 ， 我 们 最 好 能 把 这 些 东 西 去 
装 到 自 定义 的 类 里 ， 以 便 将 细节 从 程序 中 隐藏 起 来 。 为 了 实现 这 样 的 页 面 视图 ， 需 要 编写 一 些 奇特 的 代码 ， 这 些 代码 写 好 之 后 ， 其 可 复 用 程度 会 非常 高 。 这 个 封装 器 
(wrapper) [可 以 令 开发 者 把 关注 点 从 琐碎 的 代码 细节 转移 到 对 具体 内 容 的 处 理 上 面 来 。 


按照 标准 的 实现 方式 ， 数 据 源 (data source) 负责 提供 程序 所 需 的 页 面 控 制 器 。 它 会 根据 当前 给 定 的 这 个 控制 器 返回 下 一 个 或 上 一 个 控制 器 。 而 委托 则 负责 处 理 
屏幕 方向 变更 事件 以 及 与 动画 有 关 的 回调 ， 并 负责 设置 页 面 视图 控制 器 的 控制 器 数组 ， 该 数组 里 含有 一 个 或 两 个 控制 器 ， 具 体 数量 由 视图 的 排版 方式 决定 。 从 解决 方 
案 7-6 可 以 看 出 ， 尽 管 实 现代 码 有 些 乱 ， 但 是 一 旦 写 好 之 后 ， 开 友 者 融 无 须 化 太 多 时 间 来 重复 编写 这 部 分 内 容 了 。 


解决 方案 7-6 ”创建 页 面 视图 控制 器 的 封装 类 


// Define a custom delegate protocol for this wrapper class 
@protocol BookControllerDelegate <NSObject> 

- (id)viewControllerForPage: (NSInteger) pageNumber ; 
@optional 

- (NSInteger)numberOfPages; // for scrolling layouts 

- (void) bookControllerDidTurnToPage: (NSNumber *) pageNumber; 
@end 


// A book controller wraps the page view controller 
@interface BookController : UIPageViewController 
<UIPageViewControllerDelegate, UIPageViewControllerDataSource> 
+ (instancetype) bookWithDelegate: 
(id<BookControllerDelegate>) theDelegate 
style: (BookLayoutStyle)aStyle; 
- (void) moveToPage: (NSUInteger)requestedPage; 
- (int) currentPage; 


@property (nonatomic, weak) 

id <BookControllerDelegate> bookDelegate; 
@property (nonatomic, assign) NSUInteger pageNumber; 
@property (nonatomic) BookLayoutStyle layoutStyle; 
@end 


#pragma mark - Book Controller 
@implementation BookController 


#pragma mark Utility 
// Page controllers are numbered using tags 
- (NSInteger) current Page 
{ 
NSInteger pageCheck = ((UIViewController *) [self.viewControllers 
objectAtIndex:0]).view.tag; 
return pageCheck; 


#pragma mark Presentation indices for page indicator (Data Source) 
- (NSInteger)presentationIndexForPageViewController: 
(UIPageViewController *)pageViewController 


// Slightly borked in iOS 6 & 7 
// return [self currentPage]; 
return 0; 


- (NSInteger)presentationCountForPageViewController: 
(UIPageViewController *)pageViewController 


if ( bookDelegate && [ bookDelegate 
respondsToSelector:Gselector (numberOfPages)]) 
return [ bookDelegate numberOfPages]; 


return 0; 


#pragma mark Page Handling 
// Update if you'd rather use some other decision strategy 
- (BOOL)useSideBySide: (UIInterfaceOrientation)orientation 


{ 


BOOL isLandscape = 
UIInterfaceOrientationIsLandscape (orientation); 


// Each layout style determines whether side by side is used 
switch ( layoutStyle) 


{ 


case BookLayoutStyleHorizontalScroll: 

case BookLayoutStyleVerticalScroll: return NO; 
case BookLayoutStyleFlipBook: return isLandscape; 
default: return isLandscape; 


// Update the current page, set defaults, call the delegate 
- (void) updatePageTo: (NSUInteger)newPageNumber 


{ 


_pageNumber = newPageNumber ; 


[[NSUserDefaults standardUserDefaults] 
setInteger: pageNumber forKey:DEFAULTS BOOKPAGE]; 
[[NSUserDefaults standardUserDefaults] synchronize]; 


SAFE PERFORM WITH ARG(bookDelegate, 
Gselector(bookControllerDidTurnToPage:), 


@( pageNumber)); 


// Request view controller from delegate 
- (UIViewController *)controllerAtPage: (NSInteger)aPageNumber 


{ 


if ( bookDelegate && [ bookDelegate respondsToSelector: 
@selector (viewControllerForPage: ) ] ) 


UIViewController *controller = 
[ bookDelegate viewControllerForPage:aPageNumber] ; 


controller.view.tag = aPageNumber; 
return controller; 


} 


return nil; 


// Update interface to the given page 
- (void) fetchControllersForPage: (NSUInteger) requestedPage 


orientation: (UIInterfaceOrientation) orientation 


BOOL sideBySide = [self useSideBySide:orientation] ; 
NSInteger numberOfPagesNeeded = sideBySide ? 2 : 1; 
NSInteger currentCount = self.viewControllers.count; 


NSUInteger leftPage = requestedPage; 
if (sideBySide && (leftPage % 2)) 


leftPage - floor(leftPage / 2) * 2; 


// Only check against current page when count is appropriate 


if (currentCount && (currentCount -- numberOfPagesNeeded)) 
{ 

if ( pageNumber == requestedPage) return; 

if ( pageNumber == leftPage) return; 


// Decide the prevailing direction, check new page against the old 
UIPageViewControllerNavigationDirection direction - 
(requestedPage »  pageNumber) ? 
UIPageViewControllerNavigationDirectionForward 
UIPageViewControllerNavigationDirectionReverse; 


// Update the controllers, never adding a nil result 
NSMutableArray *pageControllers - [NSMutableArray array]; 
SAFE ADD(pageControllers, [self controllerAtPage:leftPagel); 
if (sideBySide) 

SAFE ADD(pageControllers, 

[Self controllerAtPage:leftPage + 1]); 

[self setViewControllers:pageControllers 

direction:direction animated:YES completion:nill; 
[self updatePageTo:leftPage]; 


// Entry point for external move request 
- (void)moveToPage: (NSUInteger)requestedPage 
{ 
// Thanks Dino Lupo 
[self fetchControllersForPage:requestedPage 
orientation: (UIInterfaceOrientation) 
self.interfaceOrientation]; 


#pragma mark Data Source 
- (UIViewController *)pageViewController: 
(UIPageViewController *)pageViewController 
viewControllerAfterViewController: 
(UIViewController *)viewController 


[Self updatePageTo: pageNumber + 1]; 


return [self controllerAtPage: (viewController.view.tag + 1)]; 


- (UIViewController *)pageViewController: 
(UIPageViewController *)pageViewController 
viewControllerBeforeViewController: 
(UIViewController *)viewController 


[self updatePageTo: pageNumber - 1]; 
return [self controllerAtPage: (viewController.view.tag - 1)]; 


#pragma mark Delegate Method 
- (UIPageViewControllerSpineLocation) pageViewController: 
(UIPageViewController *)pageViewController 
spineLocationForInterfaceOrientation: 
(UIInterfaceOrientation)orientation 


// Always start with left or single page 

NSUInteger indexOfCurrentViewController - 0; 

if (self.viewControllers.count) 
indexOfCurrentViewController - 

((UIViewController *)[self.viewControllers 
objectAtIndex:0]).view.tag; 

[self fetchControllersForPage:indexOfCurrentViewController 

orientation:orientation]; 


// Decide whether to present side by side 
BOOL sideBySide - [self useSideBySide:orientation]; 
self.doubleSided = sideBySide; 


UIPageViewControllerSpineLocation spineLocation - sideBySide ? 
UIPageViewControllerSpineLocationMid 
UIPageViewControllerSpineLocationMin; 


return spineLocation; 


// Return a new book controller 
+ (instancetype) bookWithDelegate: (id)theDelegate 
style: (BookLayoutStyle)aStyle 


// Determine orientation 
UIPageViewControllerNavigationOrientation orientation = 
UIPageViewControllerNavigationOrientationHorizontal; 
if ((aStyle == BookLayoutStyleFlipBook) || 
(aStyle == BookLayoutStyleVerticalScroll) ) 
orientation = UIPageViewControllerNavigationOrientationVertical; 


// Determine transitionStyle 
UIPageViewControllerTransitionStyle transitionStyle = 


UIPageViewControllerTransitionStylePageCurl; 
if ((aStyle == BookLayoutStyleHorizontalScroll) || 
(aStyle == BookLayoutStyleVerticalScroll)) 
transitionStyle - UIPageViewControllerTransitionStyleScroll; 


// Pass options as a dictionary. Keys are spine location (curl) 

// and spacing between vc's (scroll). 

BookController *bc - [[BookController alloc] 
initWithTransitionStyle:transitionStyle 
navigationOrientation:orientation 
options:nil]; 

bc.layoutStyle - aStyle; 

bc.dataSource = bc; 

bc.delegate - bc; 

bc.bookDelegate - theDelegate; 


return bc; 


| 


@end 


解决 方案 7-6 创 建 了 BookController 类 。 该 类 会 给 每 个 页 面 编号 ， 而 且 会 把 “下 一 页 /上 一 页 ”这 种 实现 细节 以 及 处 理 屏 幕 方向 变更 事件 所 用 的 代码 封装 起 来 。 我 
们 自 定 义 了 名 叫 BookControllerDelegate 的 委托 协议 ， 系 统 向 实现 了 该 协议 的 对 象 故 送 viewControllerForPage: 消息 时 ， 对 象 负责 返回 与 给 定 页 码 相 对 应 的 控制 
器 。 这 就 简化 了 实现 方式 ， 使 得 调用 BookController 类 的 应 用 程序 只 需 处 理 这 一 个 方法 就 好 ， 在 该 方法 里 ， 我 们 可 以 手工 构建 控制 器 ， 也 可 以 从 故事 板 中 加 载 控制 
器 。 


在 使 用 由 解决 方案 7-6 所 定义 的 BookController 类 时 ， 需 要 创建 控制 器 [他 ， 并 将 BookController 对 象 声 明成 它 的 子 视图 控制 器 ， 然 后 把 BookController 的 view 添 
加 成 它 的 子 视图 。 把 BookController 季 加 为 子 控制 器 之 后 ， 它 就 能 收 到 与 屏幕 方向 及 内 存 状况 有 关 的 事件 了 。 下 一 个 解决 方案 将 会 详细 讨论 视图 控制 器 之 间 的 这 种 关 
系 。 最 后 ， 我 们 把 初始 的 页 码 设置 好 就 行 了 。 下 面 这 段 范例 代码 演示 了 BookController 的 用 法 : 


- (void)viewDidLoad 
{ 
[super viewDidLoad] ; 
if (!bookController) 
bookController = [BookController bookWithDelegate:self 
style:BookLayoutStyleBook] ; 
bookController.view.frame = self.view.bounds; 


[self addChildViewController:bookController] ; 
[self.view addSubview:bookController.view] ; 
[bookController didMoveToParentViewController:self] ; 


[bookController moveToPage:0] ; 


创建 BookController 的 那个 便捷 方法 还 可 以 接受 第 二 个 参数 ， 即 书 的 样式 。 解 决 方案 7-6 给 开发 者 提供 了 四 种 构建 电子 书 所 用 的 样式 : 一 种 是 左右 翻 页 的 传统 样 
式 ， 还 有 一 种 是 上 下 翻 页 的 书 ， 另 外 两 种 是 滚动 展示 风格 : 


typedef enum 

{ 
BookLayoutStyleBook, // side by side in landscape 
BookLayoutStyleFlipBook, // side by side in portrait 
BookLayoutStyleHorizontalScroll, 
BookLayoutStyleVerticalScroll, 

} BookLayoutStyle; 


fEXEBERSIU RS, STN, SSR SS SENSI, RET, TBISUHUASEREGZCEBESHERHB, KEMSHHERLARAA. Mes 
Brine DIZ, BPOUMARGR SRR. 


而 “翻转 “形式 的 书 ， 其 书 背 则 是 横 背 摆 放 的 。 在 横 屏 模式 下 ， 书 背 横 放 于 屏幕 顶端 ， 每 次 只 能 显示 一 页 内 容 。 而 在 竖 屏 模式 下 ， 书 背 则 横着 摆 人 在 屏幕 中 央 ， 这 
样 就 能 显示 出 上 下 两 页 内 容 了 。 


剩 下 的 两 种 滚动 展示 风格 可 以 令 用 户 通过 水 平 滚动 或 垂直 滚动 的 方式 来 查看 不 同 的 页 面 。 如 果 使 用 了 滚动 风格 的 版 式 ， 那 么 就 不 能 同时 显示 两 页 内 容 了 。 
我 们 可 以 在 viewWillDisappear 方 法 中 清理 BookController， 将 其 从 上 级 视图 里 移 除 : 


- (void)viewWillDisappear: (BOOL)animated 
[super viewWillDisappear:animated]; 
[bookController willMoveToParentViewController:nill; 
[bookController.view removeFromSuperview]; 
[bookController removeFromParentViewController]; 


[1 是 指 范 例 代 码 中 的 BookController。 


译 者 注 
[2] 这 个 控制 器 相当 于 解决 方案 7-6 中 的 TestBedViewConttollet。 


译 者 注 


79.3 SBI SIRF 
为 了 处 理 与 委托 及 数据 源 有 关 的 任务 ， 解 决 方案 7-6 给 每 个 视图 控制 器 都 编 了 页 码 ， 并 将 其 设 为 tag。 通 过 这 个 页 码 ， 我 们 可 以 知道 当前 显示 出 来 的 是 哪 一 页 ， 而 
且 还 能 够 命令 BookControllerDelegate 去 制作 接 下 来 要 显示 的 视图 控制 器 。 


页 面 控 制 器 本 身 的 viewControllers 数 组 里 总 是 存 有 0 个 、 一 个 或 两 个 页 面 。0 个 页 面 表明 控制 器 还 没有 配置 好 。 一 个 页 面 适用 于 书 消 在 屏幕 边缘 时 的 情 ; 况 ， 而 两 个 
页 面 则 适用 于 书 背 在 屏幕 正中 时 的 情况 。 假 如 页 面 数 量 与 书 背 的 位 置 不 相 匹 配 ， 那 么 程序 在 运行 的 时 候 就 会 出 错 。 


展示 在 各 个 页 面 里 的 控制 器 是 由 两 个 数据 源 方法 提供 的 ，BookController 类 分 别 实现 了 这 两 个 方法 表示 上 一 页 和 下 一 页 的 回调 方法 。 在 页 面 控制 器 的 传统 实现 方 
式 中 ， 我 们 用 控制 器 之 间 的 前 后 关系 来 描述 它们 ， 而 不 采用 页 码 来 描述 。 但 这 条 解决 方案 所 编写 的 BookController 类 会 把 这 种 关系 替换 成 简单 的 数字 ， 并 且 会 向 Book 
ControllerDelegate 查 询 与 某 个 页 码 相 对 应 的 页 面 。 


useSideBySide: 方法 会 根据 屏幕 方向 来 决定 书 背 的 位 置 ， 并 决定 屏幕 上 同时 可 以 显示 几 个 控制 器 。 本 条 解决 方案 所 实现 的 代码 会 在 横 屏 模式 下 并 排 显示 两 页 ， 而 
在 竖 屏 模式 下 只 显示 一 页 。 你 也 可 以 根据 上 自己 的 程序 来 修改 这 段 代 码 。 比 方 说 ， 你 可 能 完 得 在 iPhone 上 面 无 论 横 屏 还 是 竖 屏 ， 都 只 应 该 显示 一 页 才 对 ， 这 样 可 以 令 文 
本 看 起 来 更 加 清晰 。 


解决 方案 7-6 提 供 了 两 种 页 面 控制 方式 ， 分 别 供用 户 与 应 用 程序 执行 翻 页 操作 。 用 户 可 以 用 滑动 手 为 翻 页 ， 也 可 以 通过 氮 击 屏幕 来 翻 页 ， 而 应 用 程序 则 可 以 友人 送 
moveToPage: 请 求 。 这 样 一 来 ， 我 们 就 能 在 UIPageViewController 的 手势 识别 器 之 外 ， 多 添加 一 种 控制 翻 页 的 方式 。 


翻 页 方向 是 通过 对 比 新 旧 两 页 的 页 码 来 确定 的 。 本 条 解决 方案 按照 西方 书籍 的 翻 页 方式 来 计算 ， 也 束 是 说 ， 右 侧 页 面 的 页 码 较 大 ， 辣 左 翻 可 以 看 到 后 面 的 内 容 。 
对 于 中 东 及 亚洲 国家 的 书籍 来 说 ， 我 们 可 以 修改 相关 的 代码 。 


解决 方案 7-6 也 采用 NSUserDefaults 来 存放 当前 的 页 面 ， 以 便 在 应 用 程序 重新 局 动 时 恢复 到 该 页 。 当 用 户 翻 到 某 个 页 面 时 ， 它 还 会 通知 委托 。 


7.9.4 构建 界面 索引 


在 滚动 排版 模式 下 ， 我 们 可 以 指定 页 面 控制 器 的 索引 index (以 便 令 用 户 能 够 通过 Page Control (页 面 控制 控件 ) 来 查看 各 页 面 ) 。 凡 是 采用 滚动 排版 风格 
(UlPageViewController-TransitionStyleScroll) 的 电子 书 都 可 以 实现 两 个 数据 源 方法 。iOS 会 用 它们 来 构建 屏幕 底部 的 Page Control 指 示 器 ， 如 图 7-5 右 侧 截图 所 


人 小。 


从 下 面 这 段 代码 中 可 以 发现 ， 这 两 个 方法 写 得 不 太 明 晰 : 


(NSInteger)presentationIndexForPageViewController: 
(UIPageViewController *)pageViewController 


// Slightly borked in iOS 6 & 7 
// return [self currentPage] ; 


return 0; 


- (NSInteger)presentationCountForPageViewController: 
(UIPageViewController *)pageViewController 


if (bookDelegate && 
[bookDelegate respondsToSelector:Gselector (numberOf Pages) ] ) 
return [bookDelegate numberOfPages] ; 


return 0; 


芋 果 公司 的 文档 里 说 ，presentationlndexForPageViewController 应 该 返回 当前 所 选 条 目的 索引 ， 但 这 样 做 会 导致 程序 的 行为 上 帮 生 混乱 (并 使 程序 朋 溃 ) 。 把 0 


当 作 界面 索引 (presentation index) ， 把 页 面 总 数 当 作 界 面 (presentation count) 【1]， 这 样 就 可 以 制作 出 最 为 稳定 的 页 面 指 示 器 了 。 我 们 把 页 面 数 量 留 给 
BookControllerDelegate 来 决定 ， 该 协议 里 有 个 名 为 numberOfPages 的 可 选 方法 。 


请 注意 ， 页 面 数量 与 count 之 间 ， 以 及 当前 页 数 与 index 之 间 ， 不 一 定 非 得 是 一 比 一 的 天 系 。 如 果 一 本 书 的 页 数 较 多 ， 那 么 可 以 把 这 个 数 与 某 数 相 除 ， 将 其 变 小 ， 
使 得 Page Control 上 面 的 每 个 圆 点 都 能 表示 5 页 或 10 页 书 ， 在 翻 书 过 程 中 ， 页 码 和 Page Control 上 面 的 圆 点 不 一 定 要 完全 精确 地 对 应 起 来 。 


Qi 革 果 公司 允许 开发 者 访问 UIPageViewControllet 的 手势 识别 器 (gesture recognizer) ， 以 便 根 据 触 摸 点 在 页 面 上 的 位 置 来 实现 触摸 式 翻 页 ， 或 是 禁用 这 种 翻 
页 方式 。 但 笔者 并 不 推荐 你 去 访问 手势 识别 器 。 首 先 ， 并 不 是 所 有 基于 触摸 的 控制 器 都 支持 这 种 做 法 。 其 次 ， 添 加 与 手势 识别 器 有 关 的 委托 方法 可 能 会 令 应 用 程序 变 


得 不 够 稳定 。 


xe 


[1] 是 指 页 面 指示 器 所 表示 的 页 面 总 数 ， 而 界面 索引 则 是 指 当 前 所 选 页 面 在 页 面 指示 器 中 的 对 应 位 置 。 译 者 注 


7.10 ”解决 方案 : 自 定义 的 容器 


苹果 公司 的 分 栏 视图 控制 器 是 个 具有 创新 意义 的 控制 器 ， 它 引入 了 “ 同 屏 显示 多 个 控制 器 ”这 一 概念 。 在 出 现 分 栏 视图 之 前 ,我 们 只 能 把 多 个 视图 同时 放 在 一 个 
控制 器 中 管理 。 而 有 了 分 栏 视图 之 后 ， 多 个 控制 器 就 能 在 屏幕 上 共存 了 ， 它 们 可 以 各 自 独立 地 对 屏幕 方向 变更 事件 及 内 存 事件 作出 响应 。 


苹果 公司 在 iOS 5SDK 中 ， 公 布 了 这 种 多 控制 器 范式 (multiple-controller paradigm) ， 它 使 得 开 友 者 可 以 设计 上 级 控制 器 ， 并 向 其 中 添加 子 控制 器 。 系 统 会 根 
据 需 要 ， 把 事件 从 上 级 控制 器 传 给 子 控制 器 。 这 样 一 来 ， 我 们 就 能 在 标签 栏 和 导航 控制 器 等 苹果 公司 内 置 的 标准 容器 之 外 ， 构 建 出 一 些 自 定 义 的 容器 。 


解决 方案 7-7 构 建 了 一 种 可 以 复 用 的 容器 ， 它 能 够 包含 一 个 或 两 个 子 控制 器 。 如 果 开 发 者 在 构建 时 为 其 加 载 了 两 个 子 视图 控制 器 ， 那 么 用 户 束 可 以 将 视图 从 一 面 番 
转 到 另 一 面 了 。 它 内 置 了 很 多 条 件 判断 语句 。 这 是 因为 ， 该 类 既 可 以 用 作 独 立 的 视图 控制 器 ， 也 可 以 把 自身 当成 子 视图 控制 器 ， 还 可 以 充当 模仿 视图 控制 器 。 我 们 现 
在 考虑 下 面 几 种 情况 。 


我 们 可 以 像 使 用 导航 控制 器 那样 ， 直 接 创建 这 种 FlipViewController， 并 把 它 设 为 主 窗 口 的 根 视图 控制 器 。 在 这 种 情况 下 ， 它 和 别 的 视图 层级 之 间 没有 任何 关系， 
它 只 需要 管理 好 自己 的 子 控制 器 束 行 了 。 另 外 ， 开 友 者 也 可 以 把 它 用 作 其 他 容器 的 子 控制 器 。 比 方 说 ， 可 以 把 它 当 作 UITabBarController 及 UlsplitViewController 等 
容器 的 子 控制 器 。 在 这 种 情况 下 ， 它 对 于 自身 的 那些 子 控制 器 来 说 是 上 级 控制 器 ;而 对 于 包含 它 的 容器 来 说 ， 则 又 成 了 子 控制 器 。 最 后 ， 开 发 者 还 可 以 直接 把 控制 器 
展示 出 来 。FlipViewController 类 必须 在 这 三 种 情况 下 都 能 稳定 运作 才 行 。 因 此 ， 这 个 控制 器 有 两 项 任务 要 完成 。 第 一 ， 它 必须 使 用 标准 的 UIKit 调 用 来 管理 自己 的 子 
控制 器 。 第 二 ， 它 还 要 注意 自己 应 该 如 何 与 视图 层级 相互 协作 。 解 决 方案 7-7 会 向 该 类 里 添加 导航 栏 ， 以 便 在 其 上 放置 供 终 端 用 户 使 用 的 Done 按 钮 。 


解决 方案 7-7 创建 视图 控制 器 容器 


- (void)viewDidDisappear: (BOOL)animated 
[super viewDidDisappear:animated]; 
if (!controllers.count) 
NSLog(G"Error: No root view controller"); 
return; 


// Clean up the child view controller 
UIViewController *currentController - 

(UIViewController *)controllers[0]; 
[currentController willMoveToParentViewController:nil]; 
[currentController.view removeFromSuperview]; 
[currentController removeFromParentViewController]; 


- (void)flip: (id)sender 

{ 
// Please call only with two controllers 
if (oontrollers.count < 2) return: 


// Determine which item is front, which is back 
UIViewController *front = (UIViewController *)controllers [0] ; 
UIViewController *back = (UIViewController *) controllers [1]; 


// Select the transition direction 
UIViewAnimationOptions transition = reversedOrder ? 
UIViewAnimationOptionTransitionFlipFromLeft 

UIViewAnimationOptionTransitionFlipFromRight; 


// Hide the info button until after the flip 
infoButton.alpha - 0.0f; 


// Prepare the front for removal, the back for adding 
[front willMoveToParentViewController:nil]; 
[self addChildViewController:back]; 


// Perform the transition 

[self transitionFromViewController: front 
toViewController:back duration:0.5f options:transition 
animations:nil completion:^(BOOL done) { 


// Bring the Info button back into view 
[self.view bringSubviewToFront:infoButton]; 


[UIView animateWithDuration:0.3f animations:^()[( 


infoButton.alpha - 1.0f; 


)1; 


// Finish up transition 
[front removeFromParentViewController]; 
[back didMoveToParentViewController:self]; 


reversedOrder - !reversedOrder; 
controllers = @[back, front]; 


yl; 


(void)viewWillAppear: (BOOL)animated 


[Super viewWillAppear:animated]; 
if (!controllers.count) 


{ 


NSLog(Ge"Error: No root view controller"); 


return; 
} 
UIViewController *front = controllers [0]; 
UIViewController *back = nil; 
if (controllers .count > 1) back = controllersI1]; 


[self addChildViewController:front]; 
[self.view addSubview:front.view]; 
[front didMoveToParentViewController:self]; 


// Check for presentation and for "flippability" 
BOOL isPresented - self.isBeingPresented; 


// Clean up instance if re-use 

if (navbar || infoButton) 
[navbar removeFromSuperview]; 
[infoButton removeFromSuperview] ; 
navbar = nil; 


// When presented, add a custom navigation bar. 
// iPhone navbar height must consider status bar. 
CGFloat navbarHeight = IS IPHONE ? 64.0 : 44.0; 
if (isPresented) 
{ 
navbar = [[UINavigationBar alloc] init]; 
[self.view addSubview:navbar] ; 
PREPCONSTRAINTS (navbar) ; 
ALIGN VIEW TOP(self.view, navbar) ; 


ALIGN VIEW LEFT(self.view, navbar); 
ALIGN VIEW RIGHT(self.view, navbar); 
CONSTRAIN HEIGHT (navbar, navbarHeight); 


// Right button is Done when VC is presented 
self.navigationItem.leftBarButtonItem - nil; 
self.navigationItem.rightBarButtonItem - isPresented ? 
SYSBARBUTTON (UIBarButtonSystemItemDone, 
Gselector(done:)) : nil; 


// Populate the navigation bar 
if (navbar) 
[navbar setItems:@[self.navigationItem] animated:NO] ; 


// Size the child VC view(s) 

CGFloat verticalOffset = 
(navbar != nil) ? navbarHeight : 0.0f; 

CGRect destFrame = CGRectMake(0.0f, verticalOffset, 
self.view.frame.size.width, 
self.view.frame.size.height - verticalOffset) ; 

front.view.frame = destFrame; 

back.view.frame = destFrame; 


// Set up info button 
if (controllers.count < 2) return; // our work is done here 


// Create the "i" button 

infoButton = [UIButton buttonWithType:UIButtonTypeInfoLight]; 

infoButton.tintColor = [UIColor whiteColor] ; 

[infoButton addTarget:self action:@selector(flip:) 
forControlEvents:UIControlEventTouchUpInside] ; 


// Place "i" button at bottom right of view 

[self.view addSubview:infoButton] ; 

PREPCONSTRAINTS (infoButton) ; 

ALIGN VIEW RIGHT CONSTANT (self.view, infoButton, 
-infoButton.frame.size.width); 

ALIGN VIEW BOTTOM CONSTANT(self.view, infoButton, 
-infoButton.frame.size.height); 


@end 


7.10.1 ”添加 与 移 除 子 视图 控制 器 


在 最 简单 的 情况 下 ， 添 加 子 视图 控制 器 需要 执行 下 列 三 步 : 

1. 调 用 上 级 控制 器 的 addChildViewController: 方法 ， 并 将 子 控制 器 作为 参数 传 入 (例如 ，[self addChildViewController: childvc]) 。 
2. 把 子 控制 器 的 视图 添加 成 上 级 视图 的 子 视图 (例如 ，[self.view addSubview: childvc.view]) . 

3. 用 适当 的 参数 调用 子 控制 器 的 didMoveToParentViewController: 方法 (例如 ，[childvc didMoveToParentViewController: self]) 。 
若 想 移 除 子 视图 控制 器 ， 则 需 执行 下 面 三 个 步骤 (基本 上 就 是 把 上 述 三 个 步骤 反 过 来 做 一 声 ) : 


1.L 以 nil 为 参数 ， 调 用 子 控制 器 的 willMoveToParentViewController: 方法 (例如 ，[childvc willMoveToParentViewController: nil]) 。 


2. 移 除 子 控制 器 的 视图 (例如 ，[childvc.view removeFromSuperview]) . 


3. 调 用 子 控制 器 的 removeFromParentViewController 方 法 (例如 ，[childvc removeFromParentViewController]) 。 


7.10.2 ”视图 控制 器 之 则 的 切换 效果 


UIKit 提 供 了 一 种 入 单 的 万 式 ， 可 以 在 切换 子 视图 控制 器 时 ， 用 动画 来 表现 视图 样 够 的 变化 过 程 。 开 发 者 需要 提供 源 视图 控制 器 、 目 标 视图 控制 器 以 及 动画 效果 的 
寺 续 时 | 间 。 此 外 也 可 以 指定 切换 动画 的 类 型 。 可 供 选 用 的 类 型 包括 翻 页 (page curl) 、 融 入 (dissolve) 及 翻转 (flip) 。 下 面 这 个 方法 会 用 简单 的 翻 页 动画 来 表现 两 
个 视图 控制 器 之 间 的 切换 过 程 : 


- (void) action: (id) sender 

{ 
[redController willMoveToParentViewController:nil]; 
[self addChildViewController:blueController] ; 


[self transitionFromViewController:redController 

toViewController:blueController 

duration:1.0f 

options:UIViewAnimationOptionLayoutSubviews | 
UIViewAnimationOptionTransitionCurlUp 

animations:^(void)(] 

completion:^(BOOL finished) { 
[redController.view removeFromSuperview] ; 
[self.view addSubview:blueController.view] ; 


[redController removeFromParentViewController] ; 
[blueController didMoveToParentViewController:self] ; 


若 想 表现 UIView 的 属性 变化 ， 我 们 不 一 定 要 在 transitionFromViewController 方 法 中 使 用 系统 内 置 的 切换 效果 。 例 如 ， 下 面 这 个 方法 将 会 重新 设置 redController 
的 中 心 点 ， 并 令 其 从 屏幕 中 淡出 ， 同 时 令 blueController 逐 渐 显 示 出 来 。 对 于 我 们 在 animations: 块 中 所 修改 的 那 几 个 UIView 属 性 来 说 ， 其 变更 过 程 都 可 以 用 动画 效 
果 表 示 : 


- (void)action: (id) sender 


( 


[redController willMoveToParentViewController:nil]; 
[self addChildViewController:blueController]; 


blueController.view.alpha = 0.0f; 
[self transitionFromViewController:redController 
toViewController:blueController 
duration:2.0f 
options:UIViewAnimationOptionLayoutSubviews 
animations:^(void)[( 
redController.view.center = CGPointMake(0.0f, 0.0f); 
redController.view.alpha - 0.0f; 
blueController.view.alpha - 1.0f; 


| 


completion:^(BOOL finished) { 
[redController.view removeFromSuperview] ; 
[self.view addSubview:blueController.view]; 


[redController removeFromParentViewController] ; 
[blueController didMoveToParentViewController:self]; 


在 系统 内 置 的 切换 效果 和 上 自 定义 的 视图 动画 之 间 ， 我 们 只 能 选择 其 中 一 种 。 要 么 在 options 参 数 中 设 定 内 置 的 切换 选项 ， 要 么 在 自 编 的 animations 块 里 面 修改 视图 
的 特征 。 知 两 种 方式 并 用 ， 则 会 产生 冲突 ， 读 者 很 容易 融 能 验证 这 一 点 。 在 completion 块 中 ， 我 们 移 除 旧 的 视图 ， 并 安排 好 新 的 视图 。 


虽说 这 里 讲 的 效果 实现 起 来 很 简单 ， 但 是 这 种 切换 方式 却 不 应 该 和 Core Animation 相 搭配 。 如 果 要 在 视图 控制 器 的 切换 过 程 中 添加 Core Animation 效果， 那么 
可 以 考虑 采用 自 定义 的 segue 来 实现 。 下 一 条 解决 方案 将 会 讲解 sgue。 


除了 上 面 提 到 的 两 种 办 法 之 外 ， 在 iOS 7 中 ， 还 有 一 种 办 法 也 能 实现 UIViewController 之 间 的 切换 动画 ， 就 是 采用 自 定义 的 切换 (custom transition) API, KE 
API 令 开 友 者 可 以 创建 出 复杂 的 动画 效果 ， 而 且 还 能 与 用 户 动 态 地 交互 。 


7.11 解决 方案 : segue 


使 用 故事 板 的 时 候 ，1B 提 供 了 一 系列 标准 的 segue， 用 以 在 视图 控制 器 乙 间 切换 。 前 面 我 们 制作 了 目 定 义 容 器 ， 现 在 来 制作 与 之 相伴 的 目 定 义 segue。 标 釜 栏 和 导 
航 控 制 器 都 能 提供 一 种 独特 的 方式 ， 用 来 在 各 种 子 视图 控制 器 之 间 切 换 ， 与 之 类 似 ， 我 们 也 可 以 构建 和 目 定 义 的 segue， 以 便 为 目 己 的 类 制作 特有 的 切换 动画 。 


由 于 IB 并 未 对 自 定义 容器 及 其 自 定义 segue 提 供 太 多 的 支持 ， 所 以 我 们 最 好 是 通过 编程 来 研发 自己 的 segue 效 果 。 下 面 这 段 代 码 可 以 实现 两 个 视图 控制 器 之 间 的 切 
换 : 


// Informal custom delegate method 
- (void) sequeDidComplete 
| 
// Retrieve the two vc's 
UIViewController *source - 
[childControllers objectAtIndex:vcIndex]; 
UIViewController *destination - 
[childControllers objectAtIndex:nextIndex]; 


// Reparent as needed 
[destination didMoveToParentViewController:self]; 
[source removeFromParentViewController]; 


// Update the bookkeeping 
vcIndex = nextIndex; 
pageControl.currentPage - vcIndex; 


// Transition to new view using custom segue 
- (void)switchToView: (int)newIndex 
goingForward: (BOOL) goesForward 


if (vcIndex == newIndex) return; 
nextIndex = newIndex; 


// Segue to the new controller 
UIViewController *source = 
[childControllers objectAtIndex:vcIndex] ; 
UIViewController *destination = 
[childControllers objectAtIndex:newIndex]; 
// Start the reparenting process 
[source willMoveToParentViewController:nil]; 
[self addChildViewController:destination]; 


RotatingSegue *segue - [[RotatingSegue alloc] 
initWithIdentifier:@"segue" 
source:source destination:destination] ; 

segue.goesForward = goesForward; 

segue.delegate = self; 

[segue perform] ; 


上 述 代码 首先 找 出 作为 “ 源 ” 和 “目标 ”的 那 两 个 子 控制 器 ， 然 后 构建 segue 并 设置 其 参数 ， 最 后 执行 此 segue。 解 决 方案 7-8 演 示 了 该 Segue 的 构建 方式 。 在 本 
例 中 ， 我 们 用 立方 体 的 旋转 来 表示 两 个 视图 之 间 的 切换 。 图 7-6 演 示 了 由 这 个 segue 所 制作 出 来 的 动画 效果 。 


segue 的 goesForward 属 性 决定 了 虚拟 的 立方 体 是 向 右 转 还 是 向 左 转 。 从 排 布 子 视图 控制 器 所 用 的 那 段 代 码 可 以 看 出 ， 本 例 使 用 了 四 个 视图 控制 器 ， 这 是 由 立方 
体 这 种 隐喻 的 特性 所 决定 的 ， 而 不 是 说 代码 里 必须 使 用 四 个 控制 器 ， 你 也 可 以 使 用 任意 数量 的 子 控制 器 。 我 们 很 容易 束 能 用 这 段 代 码 来 展示 三 个 或 七 个 子 控制 器 ， 但 
是 这 种 三 个 侧面 的 立方 体 或 七 个 侧面 的 立 万 体会 令 用 户 党 得 不 真实 。 如 果 想 增加 (或 减少 ) 这 个 多 面体 的 侧面 数量 ， 那 么 殉 要 调整 segue 动 画 的 几何 特征 ， 我 们 要 用 n 
个 侧面 的 多 面体 来 替换 本 例 所 使 用 的 立方 体 。 


E]J7-6 ”通过 自 定义 的 segue， 我 们 可 以 为 自 定义 容器 创建 出 视觉 隐喻 (visual metaphor) 。 解 决 方案 7-8 构 建 了 由 视图 控制 器 所 组 成 的 “立方 体 ”， 它 可 以 从 一 个 视图 控 
制 器 旋转 到 下 一 个 控制 器 。 每 个 控制 器 上 面 的 UISwitch 控 件 用 来 修改 图 案 的 apha 值 ， 令 其 在 完全 不 透明 与 半 透 明之 间 切 换 


解决 方案 7-8 创建 自 定 义 的 Segue 动 画 ， 表 现 视图 控制 器 之 间 的 切换 过 程 


@implementation RotatingSegue 
CALayer *transformationLayer; 
UIView weak *hostView; 


// Return a shot of the given view 

- (UIImage *)screenShot: (UIView *)aView 

| 
// Arbitrarily dims to 40%. Adjust as desired. 
UIGraphicsBeginImageContext (hostView.frame.size); 
[aView.layer renderInContext:UIGraphicsGetCurrentContext ()]; 
UIImage *image - 

UIGraphicsGetImageFromCurrentImageContext (); 

CGContextSetRGBFillColor (UIGraphicsGetCurrentContext (), 


D, Q, O, D.4E)1 
CGContextFillRect (UIGraphicsGetCurrentContext(), 
hostView.frame); 
UIGraphicsEndImageContext(); 
return image; 


// Return a layer with the view contents 
- (CALayer *)createLayerFromView: (UIView *)aView 
transform: (CATransform3D)transform 


CALayer *imageLayer - [CALayer layer]; 
imageLayer.anchorPoint = CGPointMake(1.0f, 1.0f); 


imageLayer.frame = (CGRect){.size = hostView.frame.size}; 
imageLayer.transform = transform; 

UIImage *shot = [self screenShot:aView] ; 
imageLayer.contents = ( bridge id) shot.CGImage; 


return imageLayer; 
// On starting the animation, remove the source view 
- (void) animationDidStart: (CAAnimation *) animation 
UIViewController *source = 
(UIViewController *) super.sourceViewController; 
[source.view removeFromSuperview] ; 


// On completing the animation, add the destination view, 

// remove the animation, and ping the delegate 

- (void) animationDidStop: (CAAnimation *) animation 
finished: (BOOL) finished 


UIViewController *dest = 
(UIViewController *) super.destinationViewController; 
[hostView addSubview:dest.view] ; 
[transformationLayer removeFromSuperlayer] ; 
if ( delegate && 
[ delegate respondsToSelector: 
@selector (segueDidComplete) ] ) 


[ delegate segueDidComplete] ; 


// Perform the animation 

- (void) animateWithDuration: (CGFloat) aDuration 
CAAnimationGroup *group = [CAAnimationGroup animation] ; 
group.delegate = self; 


group.duration = aDuration; 


CGFloat halfWidth = hostView.frame.size.width / 2.0f; 
float multiplier - goesForward ? -1.0f : 1.0f; 


// Set the x, y, and z animations 
CABasicAnimation *translationX - [CABasicAnimation 
animationWithKeyPath:@"sublayerTransform.translation.x"] ; 
translationX.toValue = 
[NSNumber numberWithFloat:multiplier * halfWidth] ; 


CABasicAnimation *translationZ = [CABasicAnimation 
animationWithKeyPath:G"sublayerTransform.translation.z"]; 
translationZ.toValue = [NSNumber numberWithFloat:-halfWidth]; 


CABasicAnimation *rotationY - [CABasicAnimation 
animationWithKeyPath:@"sublayerTransform.rotation.y"] ; 
rotationY.toValue = 
[NSNumber numberWithFloat: multiplier * M PI 2]; 


// Set the animation group 

group.animations = [NSArray arrayWithObjects: 
rotationY, translationX, translationZ, nil]; 

group.fillMode - kCAFillModeForwards; 

group.removedOnCompletion - NO; 


// Perform the animation 
[CATransaction flush]; 
[transformationLayer addAnimation:group forKey:kAnimationKey]; 


- (void)constructRotationLayer 
( 
UIViewController *source - 
(UIViewController *) super.sourceViewController; 
UIViewController *dest - 
(UIViewController *) super.destinationViewController; 
hostView - source.view.superview; 


// Build a new layer for the transformation 
transformationLayer - [CALayer layer]; 
transformationLayer.frame - hostView.bounds; 
transformationLayer.anchorPoint = CGPointMake(0.5f, 0.5f); 
CATransform3D sublayerTransform - CATransform3DIdentity; 
sublayerTransform.m34 - 1.0 / -1000; 

[transformationLayer setSublayerTransform:sublayerTransform]; 
[hostView.layer addSublayer:transformationLayer]; 


// Add the source view, which is in front 
CATransform3D transform - CATransform3DMakeIdentity; 


[transformationLayer addSublayer: 
[self createLayerFromView:source.view 
transform:transform]]; 


// Prepare the destination view either to the right or left 
// at a 90/270 degree angle off the main 
transform = CATransform3DRotate (transform, M PI 2, 0, 1, 0); 
transform = CATransform3DTranslate (transform, 
hostView.frame.size.width, 0, 0); 
if (!goesForward) 
| 
transform - 
CATransform3DRotate (transform, M PI 2, 0, 1, 0); 
transform - 
CATransform3DTranslate (transform, 
hostView.frame.size.width, 0, 0); 
transform - 
CATransform3DRotate (transform, M PI 2, 0, 1, 0); 
transform - 
CATransform3DTranslate (transform, 
hostView.frame.size.width, 0, 0); 


| 


[transformationLayer addSublayer: 
[self createLayerFromView:dest.view 
transform:transform]]; 


// Standard UIStoryboardSegue perform 
- (void)perform 


| 


[self constructRotationLayer]; 
[self animateWithDuration:0.5f]; 


| 


@end 


segue JIB 


从 iOS 6SDK 开 始 ， 开 发 者 就 可 以 在 故事 板 中 运用 自 定 义 的 segue 了 。 我 们 需要 把 这 些 segue 绑 定 到 某 些 动作 项 (action item) 上 面 ， 例 如 按钮 或 
UIBarButtonltem 上 面 ， 或 绑 定 到 那 种 可 以 执行 类 似 操作 的 元 件 上 面 。 图 7-7 演 示 了 IB 所 列 出 的 自 定 义 segue。 名 为 rotating 的 那个 segue 是 我 们 在 解决 方案 7-8 中 编写 
的 。 


此 外 ，segue 还 可 以 回 退 (unwind) 。 系 统 可 以 用 开发 者 所 提供 的 自 定 义 segue， 由 新 的 视图 控制 器 退 到 它 逻 辑 上 的 父 控制 器 (logical parent) 。 想 实现 此 功 
能 ， 需 要 编写 下 面 几 个 方法 : 


: #ecanPerformUnwindSegueAction: fromViewController: withSender: 方法 里 指定 是 否 可 以 执行 回 退 。 


- 在 viewControlletrForUnwindSegueAction: fromViewController: with-Sender: 方法 中 返回 将 要 回 退 到 的 那个 视图 控制 器 。 
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图 7-7 开发 者 可 在 故事 板 里 运用 自 定义 的 segue。IB 会 扫描 UIStoryboardSegue 的 子 类 。 此 处 ，IB 会 列 出 我 们 自制 的 名 为 fotating 的 segue 以 及 由 系统 提供 的 那些 segue 


: 经 由 segueForUnwindingToViewControlletr: fromViewController: identi-fier: 方法 提供 回 退 时 所 需 的 Segue 实 例 。 一 般 来 说 ， 此 segue 播 放 动 画 的 方向 应 该 和 原来 那个 


segue 相 反 。 


最 后 ， 我 们 可 以 通过 实现 shouldPerformSegueWithldentifier: sender: 方法 来 启用 或 禁用 segue。 开 发 者 可 以 返回 YES 或 NO， 用 以 表明 是 否 需 要 处 理 指定 的 


segue, 


本 章 演示 了 很 多 种 视图 控制 器 类 。 读 者 学 到 了 如 何 用 它们 来 展示 视图 ， 以 及 怎样 为 用 户 提供 与 硬件 设备 相符 的 导航 方式 。 大 家 还 看 到 了 如 何在 既 满 足 应 用 程序 需 
求 又 遵循 相关 平台 HIG 规 范 的 前 提 下 ， 用 这 些 类 来 拓展 虚拟 的 操作 空间 并 创建 多 页 界面 。 开 始 阅读 下 一 章 之 前 ， 请 先 回顾 下 面 几 个 问题 : 


- 用 导航 树 构 建 分 层 的 界面 。 在 浏览 文件 结构 或 构建 由 设置 选项 所 组 成 的 树 状 结构 时 ， 导 航 树 是 很 有 用 的 。 如 果 要 显示 细节 视图 或 包含 许多 选项 的 视图 ， 那 么 
以 考虑 把 这 个 新 视图 控制 器 推 入 导航 栈 ， 或 用 分 栏 视图 将 其 直接 显示 出 来 。 


在 完全 符合 苹果 公司 《HIG》 (人 机 界面 指南 ) 的 前 提 下 ， 不 妨 试 着 以 非常 规 的 方式 去 使 用 常规 的 UI 元 件 。 我 们 可 以 彻底 抛 开 UINavigationController 类 的 导航 功 
能 ， 而 以 一 种 新 颖 的 方式 来 使 用 它 。 开 发 者 可 以 按照 自己 的 需要 去 使 用 这 些 工具 。 


- 善 用 持久 化 机 制 。 用 户 下 次 启动 程序 的 时 候 ， 其 GUI 状态 应 该 和 上 次 离开 时 相同 。NSUsetDefaults 提 供 了 一 套 内 置 的 信息 保存 系统 ， 使 开发 者 可 以 在 下 次 启动 程 
序 时 恢复 它们 。 我 们 可 以 用 NSUserDefaults 里 的 信息 来 重建 界面 ， 使 其 恢复 到 上 次 的 状态 。iOS 6 引入 了 State Preservation and Restoration API， 它 提供 了 另 一 种 方式 ， 可 
用 来 保存 大 部 分 UI 状态 


- 把 程序 做 得 通用 一 些 。 我 们 所 写 的 程序 要 能 自动 适应 各 种 硬件 设备 ， 而 不 是 在 所 有 设备 上 都 只 展示 iPhone 或 iPad 样 式 的 界面 。 本 章 简 述 了 一 些 在 程序 运行 时 检测 
设备 特征 所 用 的 办 法 以 及 一 些 更 新 界面 所 用 的 技巧 ， 读 者 可 以 由 此 为 基础 来 扩充 这 些 代 码 ， 并 把 它们 运用 到 更 为 复杂 的 情境 中 去 。 要 想 把 程序 设计 得 通用 一 些 ， 不 能 
只 考虑 拉 伸 视图 或 加 载 不 同 的 图 人 案 及 XIB 文 件 等 手段 ， 还 应 该 考虑 到 用 户 会 以 什么 样 的 方式 来 操作 程序 ， 以 及 程序 在 这 种 硬件 平台 上 应 该 显示 出 什么 风格 的 界面 。 


- 操作 自 定义 的 容器 时 ， 可 以 考虑 直接 使 用 故事 板 。 这 样 的 话 ， 我 们 就 不 用 再 构建 并 保留 一 个 数组 ， 然 后 把 所 有 控制 器 全 都 放 到 里 面 了 。 开 发 者 可 通过 故事 板 直 
接 访问 这 些 元 件 。 与 本 章 新 编 的 那个 页 面 视图 控制 器 类 一 样 ， 我 们 应 该 等 程序 需要 用 到 相关 控制 器 的 时 候 ， 再 去 加 载 它 。 


第 8 重音 用 的 控制 器 


iOS SDK 内 置 了 很 多 种 由 系统 所 提供 的 控制 器 ， 开 发 者 可 在 日 常 编码 工作 中 使 用 它们 。 本 章 要 介绍 其 中 最 常用 的 几 种 。 读 者 将 会 学 到 如 何 从 设备 的 媒体 库 里 选择 图 
片 、 如 何 拍 摄 照片 以 及 如 何 记 录 并 编辑 i 视频。 笔者 还 要 讲解 怎样 令 用 户 在 程序 中 编写 电子 邮件 和 文本 消息 ， 以 及 怎样 使 用 户 能 够 在 Twitter 及 Facebook 等 社交 网 站 上 
面 发 表 文 章 。 每 个 控制 器 都 提供 了 一 种 方式 ， 开 发 者 可 通过 这 种 方式 来 使 用 IOs 系 统 内 置 的 功能 。 


8.1 图像 选 取 器 控制 器 
UlimagepickerController 类 使 得 用 户 能 够 从 设备 的 媒体 库 里 选择 图 像 ， 并 通过 设备 的 摄像 头 来 拍摄 图 片 。 它 在 某 种 程度 上 是 个 “活化 石 ”， 早 在 iphone OS 时 


代 ， 系 统 束 开始 提供 这 个 界面 了 。 人 在 苹果 公司 推出 新 设备 的 过 程 中 ， 这 个 类 也 跟着 不 断 进化 ，iOS 3.1 为 其 添加 了 视频 录制 功能 ，iOS 4 为 其 添加 了 前 后 摄像 头 功能 。 
户 可 以 用 它 来 编辑 照片 及 视频 ， 也 可 以 自 定义 显示 在 拍照 界面 上 的 图 案 等 。 


8.1.1 图 像 来 源 


图 像 选取 器 可 以 使 用 下 面 三 种 图 像 来 源 : 


种 类 型 的 图 像 来 源 包含 了 所 有 同步 到 iOS 上 面 的 图 像 。 其 内 容 包 括 用 户 (通过 Camera Roll 程 序 ) 拍摄 


: UllmagePickerControllerSourceTypePhotoLibrary— ix 
的 图 像 、 通 过 Photo Stream (A PA) 获取 到 的 图 像 、 从 电脑 同步 过 来 的 相册 以 及 经 由 Cameta Connection Kit 拷 贝 的 图 像 等 。 


这 种 类 型 的 图 像 来 源 仅 局 限于 Cameta Roll， 对 于 带 有 摄像 头 的 设备 来 说 ， 它 包括 用 户 所 拍摄 的 
照片 及 视频 ; 而 对 于 没有 摄像 头 的 设备 来 说 ， 它 表示 Saved Photos 相 册 中 的 照片 。 其 他 设备 上 的 照片 如 果 经 由 Photo Stteam 串 流 过 来 ， 那 么 也 会 同步 到 CametaRoll 里 。 


- UllmagePickerControllerSourceTypeSavedPhotosAlbum 


- UllmagePickerControllerSourceTypeCamera——4e RF KH A ARAB IK A UllmagePickerControllerSourceTypeCamera, AKA Jf P 3T AIH itiPhone A 3.0543 


像 头 来 拍摄 图 片 了 。 用 户 可 以 在 前 后 两 个 摄像 头 之 间 切 换 ， 也 可 以 选择 是 拍摄 静态 照片 还 是 录制 动态 影像 。 


系统 目前 提供 了 上 述 三 种 数据 来 源 ， 使 得 开发 者 既 可 以 访问 整个 媒体 库 ， 也 可 以 将 范围 限定 在 Camera Roll 或 Camera 中 。 你 也 许 还 想 更 为 精细 地 控制 应 用 程序 对 
iCloud 的 访问 以 及 对 共享 Photo Stream 及 单个 Photo Stream 的 访问 。 这 些 改进 建议 可 以 提交 到 http://bugreport.apple.com/。 


8.1.2 在 iPhone 和 iPad 中 显示 i 先 取 器 


图 8-1 演 示 了 由 iPhone 和 iPad 所 展示 的 图 像 选取 器 界面 ， 其 图 片 来 源 是 媒体 库 中 的 所 有 图 片 。 在 iPhone 系列 的 设备 上 ， 我 们 把 UlImagePickerController 类 以 模 
态 界 面 的 形式 显示 出 来 (如 左 侧 截图 所 示 ) ， 而 在 平板 电脑 上 ， 则 将 其 显示 成 popover 形 式 (如 右 侧 截 图 所 示 ) 。 
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图 8-1 用 户 可 以 通过 系统 自 带 的 图 像 选 取 器 从 媒体 库 里 存储 的 图 片 中 选择 图 像 


在 iPhone 系 列 的 设备 上 ， 应 该 以 模仿 界面 的 形式 来 展示 选取 器 。 而 在 iPad 上 面 ， 则 应 把 它 窝 套 到 popover 里 。 开 发 者 不 应 该 把 图 像 选取 器 推 入 现 有 的 导航 栈 。 如 
果 在 老 版 本 的 iOS 系 统 上 这 样 做 ， 那 么 会 使 现 有 的 主导 航 栏 下 方 出 现 另 一 个 导航 栏 。 若 是 在 新 版 OS 系统 上 面 这 样 做 ， 则 会 令 程序 抛 出 异常 : "Pushing a navigation 


controller is not supported by the image picker" , 


8.2 解决 方案 : 选取 图 像 


图 像 选 取 器 最 简单 的 用 法 是 令 用 户 浏 览 媒 体 库 ， 并 从 中 选取 一 张 保存 过 的 图 片 。 解 决 方案 8-1 演 示 了 怎样 创建 并 展示 选取 器 以 及 怎样 获取 用 尸 所 选 的 图 像 。 在 学 习 
通常 的 使 用 方法 之 前 ， 我 们 先 来 讲 两 个 关键 问题 。 


8.2.1 elses Pav 


在 Mac 上 面 运 行 本 条 解决 方案 之 前 ， 我 们 可 能 先 得 往 模 拟 器 的 媒体 库 里 添加 一 些 图 片 才 行 。 有 两 种 办 法 可 以 添加 图 片 。 第 一 种 办 法 是 把 图 像 从 Finder 拖 放 到 模拟 
器 里 。 模 拟 器 会 用 Mobile Safari 浏览 器 将 图 片 打开 ， 此 时 开 上 友 者 可 以 按 住 图 片 不 放 ， 然 后 选择 Save Image， 这 样 束 能 把 图 片 拷 贝 到 照片 库 了 。 


设置 好 测试 用 的 图 片 之 后 ， 在 Mac 里 打开 home 目 录 Library 子 目录 下 的 Application Support 文 件 夹 。 然 后 打开 其 下 的 iPhone Simulator 文 件 夹 ， 再 打开 与 当前 
iOS 版 本 相对 应 的 文件 夹 (例如 7.0) 。 在 这 个 文件 中 ， 就 可 以 看 到 Media 文 件 夹 了 。Media 文 件 夹 的 路 径 是 这 个 样子 的 : /Users/ (你 的 用 户 名 ) /Library/Application 
Support/iPhone Simulator/ (iOS 版 本 ) /Media。 


我 们 可 以 把 刚 生 成 的 Media 文 件 夹 备 份 到 一 个 方便 取 用 的 位 置 。 创 建 好 备份 之 后 ， 将 来 残 不 用 再 重新 添加 每 张 照 上 请 了 。 每 次 重 置 模拟 器 的 内 容 与 配置 时 ， 系 统 都 
会 把 这 些 图 片 删 挥 。 而 有 了 这 样 的 备份 之 后 ， 开 改 者 区 能 随时 用 它 来 执行 测试 了 ， 并 且 还 能 节省 很 多 时 间 。 


另外 一 种 办 法 是 购买 Ecamm 的 PhoneView 软 件 (http://ecamm.com/) ， 该 软件 可 以 通过 Apple File Connection (AFC) 服务 访问 设备 的 Media 文 件 夹 。 把 
iPhone 或 ijPad 设 备 与 电脑 相连 ， 启 动 应 用 程序 ， 然 后 将 文件 夹 从 PhoneView 软 件 拖 放 到 Mac 之 中 。 一 定 要 在 PhoneView 的 preferences 里 面 把 Show Entire Disk 选 
中 ， 这 样 才能 看 到 与 图 片 有 关 的 所 有 文件 夹 。 


用 PhoneView 软 件 把 DCIM、PhotoData 及 Photo 文 件 夹 拷贝 到 Macintosh 上 面 的 某 个 文件 夹 中 。 拷 贝 完 之 后 ， 退 出 模拟 器 ， 并 把 刚才 拷贝 的 那 三 个 文件 夹 添加 


到 ~/Library/Application Support/iPhone Simulator/ (iOs 版 本 ) /Media 里 。 下 次 启动 模拟 器 的 时 候 ， 就 能 在 Photos 程 序 中 看 到 这 些 新 的 媒体 资源 了 。 


8.2.2 AssetsLibrary 模 块 


这 条 解决 方案 要 使 用 AssetsLibrary 模 块 。 请 在 源 文 件 里 通过 @import AssetsLibrary 指 令 将 其 引入 。 

采用 AssetsLibrary 模 块 这 一 做 法 听 上 去 似乎 有 些 复杂 ， 但 为 了 能 够 更 好 地 使 用 图 像 选取 器 ， 我 们 确实 有 必要 这 么 做 。 因 为 图 像 选 取 器 返回 的 也 许 不 是 一 张 直接 能 
够 使 用 的 图 像 ， 而 是 一 个 资源 URL (asset URL) 。 解 决 方案 8-1 考 虑 到 了 这 种 情况 ， 所 以 ， 它 提供 了 名 为 loadlmageFromAssetURL: into: 的 方法 ， 用 以 从 资源 库 
(assets library) 中 载 入 图 像 。 资 源 URL 通 常 是 这 个 样子 的 : 


assets-library://asset/asset.JPG?id-553F6592-43C9-45A0-B851-28A726727436&ext -JPG 
上 述 URL 可 以 直接 访问 对 应 的 媒体 资源 。 


原来 访问 资源 库 时 有 个 非 营 恼人 的 问题 ， 所 乎 苹果 公 司 现在 已 经 将 它 解决 了 。 以 前 ，iO3 会 询问 用 户 是 否 允 许 程序 访问 媒体 资源 中 的 位 置 (location) 信息 ， 而 用 
户 一 般 会 拒绝 。 由 于 应 用 程序 无 法 迫使 系统 再 次 询问 用 户 ， 所 以 它 会 卡 在 这 里 。 从 iOS 6 开始 ， 这 条 询问 消息 不 再 说 程序 会 访问 位 置 了 ， 而 是 改 说 应 用 程序 想 要 访问 用 
户 的 照片 ， 这 样 一 来 ， 用 户 很 可 能 会 允许 该 请 求 。 我 们 可 以 通过 查询 ALAssetsLibrary 的 authorizationStatus 方 法 来 获知 授权 情况 。 用 户 若 想 重 置 已 经 授予 的 权限 ， 可 
以 打开 settings> Privacy， 然 后 在 每 个 应 用 程序 中 调整 那些 基于 服务 的 许可 (例如 对 位 置 与 照片 的 访问 权限 ) 。 


不 过 ,苹果 公司 在 初版 的 iOS 7 系统 中 ， 又 引入 了 一 个 与 iPad 上 面 的 资源 库 授权 有 关 的 bug。 如 果 在 popover 中 显示 选取 器 ， 那 么 当 程 序 从 征求 用 尸 许可 的 界面 返 


回 时 ， 融 会 月 溃 。 昌 说 重启 应 用 程序 即 可 解决 此 问题 ， 但 在 切 次 局 动 程序 时 ， 毕 竞 会 造成 烘 糕 的 用 户 体验 。 有 个 解决 办 法 是 在 显示 popover 之 前 ， 先 请 求 用 户 人 允 许 应 
用 程序 访问 资源 库 : 


// Force authorization for asset library 
[assetsLibrary enumerateGroupsWithTypes:ALAssetsGroupAll 
usingBlock:^(ALAssetsGroup *group, BOOL *stop) { 


// If authorized, catch the final iteration and display popover 
if (group zz nil) 


| 
dispatch async(dispatch get main queue(), ^( 
popover - [[UIPopoverController alloc] 
initWithContentViewController: 
viewControllerToPresent]; 
popover.delegate - self; 
[popover presentPopoverFromBarButtonItem: 


self.navigationlItem.rightBarButtonItem 
permittedArrowDirections: 


UIPopoverArrowDirectionAny 
animated:YES]; 
My 
| 
*stop = YES; 
| failureBlock:nil]; 


讲 完 相关 的 细节 问题 之 后 ， 下 一 节 我 们 开始 介绍 图 像 选 取 器 本 身 的 用 法 。 


8.2.3 ”展示 选取 器 


首先 创建 并 初始 化 图 像 选 取 器 ， 然 后 把 它 的 来 源 类 型 设置 成 UllmagePicker-ControllerSourceTypePhotoLibrary (表示 媒体 库 中 的 所 有 图 片 ) 或 
UllmagePicker-ControllerSourceTypeSavedPhotosAlbum (表示 用 户 拍摄 的 图 片 ) 。 解 决 方案 8-1 把 sourceType 设 置 成 
UllmagePickerControllerSourceTypePhotoLibrary， 使 得 用 户 可 以 浏览 媒体 库 中 的 所 有 图 片 。 


UIImagePickerController *picker = [[UIImagePickerController alloc] init]; 
picker.sourceType - 


UIImagePickerControllerSourceTypePhotoLibrary; 


还 有 个 可 选 的 属性 叫 作 allowsEditing， 如 果 将 其 打开 ， 那 么 用 户 在 操作 图 像 选 取 器 的 时 候 ， 融 可 以 多 执行 一 步 。 开 局 该 属性 后 ， 用 户 可 以 在 完成 选取 操作 之 前 ， 
先 对 所 选 图 像 执 行 缩放 及 调整 。 如 果 和 共用 该 属性 ， 那 么 只 要 用 己 选 择 了 图 像 ， 系 统 融会 立刻 把 控制 权 交 给 选取 器 程序 ， 并 使 其 进入 生命 期 的 下 一 个 阶段 。 


一 定 要 设置 选取 器 的 delegate 属 性 。 这 个 delegate 要 遵循 UINavigation-ControllerDelegate 及 UllmagepPickerControllerDelegate 协 议 。 当 用 户 选 择 了 某 个 图 像 
或 是 取消 了 这 次 选择 操作 之 后 ，delegate 会 收 到 相应 的 回调 消息 。 如 果 把 UllmagepPickerController 和 popover 结 合 起 来 使 用 ， 那 么 还 应 该 令 delegate 遵 循 
UIPopoverControllerDelegate 协 议 。 


在 iPhone 系列 的 设备 上 面 ， 总 是 应 该 以 模 态 方式 来 展示 选取 器 ， 我 们 需要 在 程序 运行 的 时 候 判 断 设 备 类 型 。 当 程序 运行 在 iPhone 上 时 ， 下 列 测 试 语句 会 返回 
true， 如 果 运 行 在 iPad 上 ， 则 返回 false (适用 于 iOS 3.2 及 后 续 系 统 ) : 


#define IS IPHONE (UI USER INTERFACE IDIOM() == UIUserInterfaceIdiomPhone) 


下 面 这 段 代 码 以 弟 用 的 展示 方式 来 显示 图 像 选取 器 : 


if (IS IPHONE) 


| 
[self presentViewController:picker animated:YES completion:nil]; 
| 
else 
{ 
if (popover) [popover dismissPopoverAnimated:NO] ; 
popover = [[UIPopoverController alloc] 
initWithContentViewController:picker] ; 
popover.delegate = self; 
[popover presentPopoverFromBarButtonItem: 
self .navigationItem.rightBarButtonItem 
permittedArrowDirections:UIPopoverArrowDirectionAny 
animated:YES]; 
} 


8.2.4 ”人 处理 delegate 的 回调 


解决 方案 8-1 考 虑 了 下 面 三 种 在 使 用 图 像 选取 器 时 可 能 发 生 的 回调 : 
用 户 成 功 地 选 定 了 一 张 图 像 。 
. 用 户 点 击 了 Cancel (只 会 发 生 在 模 态 界面 中 ) 。 
- 用 户 在 popovet 的 范围 之 外 点 击 屏 幕 ， 从 而 隐藏 了 谈 有 选取 器 的 popovet。 


后 面 两 种 情况 比较 简单 。 对 于 模 态 界面 来 说 ， 把 控制 器 隐藏 起 来 就 好 。 对 于 popover 来 说 ， 不 要 令 局 部 引用 再 持 有 popover 实 例 即 可 。 而 要 处 理 用 户 选 好 的 图 像 ， 
则 需要 多 编写 一 些 代码 才 行 。 


选取 器 会 向 其 delegate 返 回 一 份 含有 目 定 义 信息 的 字典 (dictionary) ， 然 后 它 的 生命 期 残 结 束 了 。 这 个 字典 里 面包 含 与 用 户 所 选 内 容 相 关 的 键 值 对 。 字 典 里 可 能 
只 有 几 个 键 (key) ， 也 可 能 会 有 很 多 键 ， 具体 数 量 取 决 于 开发 者 配置 图 像 选 取 器 的 方式 以 及 用 尸 所 选 媒 体 资 源 的 类 型 。 


解决 方案 8-1 ARER 


#define IS IPHONE (UI USER INTERFACE IDIOM() 


Il 
T 
P. 2 


UIUserInterfaceIdiomPhone) 


// Dismiss the picker 


- (void)performDismiss 


{ 


if (IS IPHONE) 
[self dismissViewControllerAnimated:YES completion:nil]; 


else 


{ 


[popover dismissPopoverAnimated: YES] ; 


popover 


= nil; 


// Present the picker 


- (void) presentViewController: 


(UIViewController *)viewControllerToPresent 


if (IS IPHONE) 


| 


[self presentViewController:viewControllerToPresent 


else 


animated:YES completion:nil]; 


// Workaround to an Apple crasher when asking for asset 


// library authorization with a popover displayed 


ALAssetsLibrary * assetsLibrary - 


[[ALAssetsLibrary alloc] init]; 


ALAuthorizationStatus authStatus; 


if (NSFoundationVersionNumber » 


else 


NSFoundationVersionNumber iOS 6 0) 


authStatus - [ALAssetsLibrary authorizationStatus]; 


authStatus - ALAuthorizationStatusAuthorized; 


if (authStatus -- ALAuthorizationStatusAuthorized) 


popover - [[UIPopoverController alloc] 


initWithContentViewController:viewControllerToPresent]; 


popover.delegate - self; 
[popover presentPopoverFromBarButtonItem: 


self.navigationItem.rightBarButtonItem 
permittedArrowDirections:UIPopoverArrowDirectionAny 


animated:YES]; 


} 


else if (authStatus == ALAuthorizationStatusNotDetermined) 
( 
// Force authorization 
[assetsLibrary enumerateGroupsWithTypes:ALAssetsGroupAll 
usingBlock:^(ALAssetsGroup *group, BOOL *stop) { 
// If authorized, catch the final iteration 
// and display popover 


it {group se nil) 
{ 
dispatch async(dispatch get main queue(), ^f 
popover = [[UIPopoverController alloc] 


initWithContentViewController: 
viewControllerToPresent]; 
popover.delegate - self; 
[popover presentPopoverFromBarButtonItem: 
self.navigationItem.rightBarButtonItem 
permittedArrowDirections: 
UIPopoverArrowDirectionAny 
animated:YES]; 
)3; 
} 
*stop = YES; 
} failureBlock:nil]; 


// Popover was dismissed 
- (void)popoverControllerDidDismissPopover: 
(UIPopoverController *)aPopoverController 


popover = nil; 


// Retrieve an image from an asset URL 
- (void) loadiImageFromAssetURL: (NSURL *) assetURL 
into: (UIImage **) image 


ALAssetsLibrary *library = [[ALAssetsLibrary alloc] init]; 
ALAssetsLibraryAssetForURLResultBlock resultsBlock = 
“(ALAsset *asset) 


ALAssetRepresentation *assetRepresentation = 

[asset defaultRepresentation] ; 
CGImageRef cgImage = 

[assetRepresentation CGImageWithOptions:nil]; 
CFRetain(cgImage); // Thanks, Oliver Drobnik 
if (image) *image - [UIImage imageWithCGImage:cgImage]; 
CFRelease (cgImage) ; 


ALAssetsLibraryAccessFailureBlock failureBlock - 
^(NSError * strong error) 


NSLog(G"Error retrieving asset from url: %@", 
error.localizedFailureReason); 


bi 


[library assetForURL:assetURL 
resultBlock:resultsBlock failureBlock:failureBlock] ; 


// Update image and for iPhone, dismiss the controller 
- (void) imagePickerController: (UIImagePickerController *)picker 
didFinishPickingMediaWithInfo: (NSDictionary *) info 


// Use the edited image if available 
UIImage autoreleasing *image = 
info [UIImagePickerControllerEditedImage] ; 


// If not, grab the original image 
if (!image) 


image = info[UIImagePickerControllerOriginalImage]; 


// I£ still no luck, check for an asset URL 
NSURL *assetURL = info[UIImagePickerControllerReferenceURL] ; 
if (!image && !assetURL) 


{ 
} 


else if (!image) 


( 


NSLog(G"Cannot retrieve an image from the selected item. Giving up."); 


// Retrieve the image from the asset library 
[self loadImageFromAssetURL:assetURL into:&image]; 


// Display the image 
if (image) 


imageView.image - image; 


if (IS IPHONE) 
[self performDismiss]; 


// iPhone-like devices only: dismiss the picker with cancel button 
- (void)imagePickerControllerDidCancel: 
(UIImagePickerController *)picker 


[self performDismiss]; 


- (void)pickImage 


| 


if (popover) return; 


// Create and initialize the picker 
UIImagePickerController *picker - 
[[UIImagePickerController alloc] init]; 
picker.sourceType = 
UIImagePickerControllerSourceTypePhotoLibrary; 
picker.allowsEditing - editSwitch.isOn; 
picker.delegate - self; 


[self presentViewController:picker]; 


获取 解决 方案 代码 
访问 https://github.com/erica/iOS-7-Cookbook 网 页 ， 并 打开 “C08Common Controllers ”文件 夹 ， 即 可 找到 与 本 章 中 的 解决 方案 相对 应 的 完整 范例 项 目 。 


比方 说 ， 如 果 我 们 通过 Safari 把 图 像 保存 到 模拟 器 ， 然 后 叉 选 中 了 这 些 图 像 ， 那 么 字典 里 就 只 有 “媒体 类 型 ”和 “引用 URL” 这 两 个 键 。 如 果 图 片 是 用 户 用 设备 提 
摄 的 ， 而 县 还 经 过 了 编辑 ， 那 么 图 像 选 取 器 所 返回 的 字典 里 就 会 包含 下 面 六 个 键 : 


- UIImagePickerControllerMediaType 它 表 示 用 户 所 选 的 媒体 资源 是 何 类 型 。 一 般 来 说 ，public.image 表 示 图 片 ，public.movie 表 示 影 像 。 媒 体 类 型 定义 于 Mobile 
Core Setvices 框 架 之 中 。 在 使 用 图 像 选 取 器 的 时 候 ， 媒 体 类 型 主要 用 来 把 用 户 所 选 内 容 添加 到 系统 的 剪贴 板 里 。 


它 是 NSValue， 其 中 存放 CGRect， 用 来 描述 用 户 所 选 的 部 分 图 像 。 


: UIImagePickerControllerCropRect 


- UIImagePickerControllerOriginalImage 它 对 应 于 一 个 UIImage 实 例 ， 该 实例 表示 原始 的 〈 也 就 是 没有 经 过 编辑 的 ) 图 像 内 容 。 


它 对 应 于 编辑 之 后 的 图 像 ， 其 中 包含 用 户 所 选 定 的 那 一 部 分 。 这 个 UIImage 比 较 小 ， 它 是 按照 设备 屏幕 尺寸 调整 过 


: UIImagePickerControllerEditedImage 


 UIImagePicketConttolletRefetenceURI 一 -一 它 表 示 文 件 系统 中 的 URL， 该 URL 指 向 用 户 所 选 的 资源 。 无 论 用 户 是 否 裁 切 过 图 像 或 剪辑 过 影片 ， 这 个 URL 总 是 指向 资 


源 的 原始 版 本 。 


它 表示 用 户 在 图 像 选取 器 内 所 拍照 片 的 metadata (元 数据 ) o 


: UIImagePickerControllerMediaMetadata 


73 T TRISZEBRERBSPJSSSABURUBAEDMR, HADRS-IRMSS OR Bt, vcr ARARE. BERDE, AARRE. WER 
这 一 操作 也 失败 了 ， 那 么 就 从 reference URL 中 获取 图 像 ， nasi 一 般 来 说 ， 执 行 完 这 些 步 又 之 后 ， 应 用 程序 都 会 获取 到 可 供 操作 的 有 效 
Ullmage 实 例 。 大 是 没有 这 样 的 实例 ， 那 么 残 记录 错误 信息 并 返 


最 后 ，delegate 的 回调 方法 在 完成 其 任务 之 前 ， 不 要 忘 了 把 模 态 形式 的 控制 器 关 掉 。 


Qi 如 果 把 各 种 用 户 操作 都 比 作 动 物 的 话 ， 那 么 UIImagePickerConttollet 就 是 一 头 牛 。 它 行动 比较 缓慢 ， 非 常 容易 消耗 应 用 程序 的 内 存 ， 而 且 还 要 花 些 时 间 
来 “反刍 ” (chew its cud) 。 所 以 ， 在 设计 程序 的 时 候 要 注意 这 些 限 制 ， 不 要 因为 使 用 图 像 选取 器 而 影响 整个 应 用 程序 的 效果 。 


0.3 HEAD: HHA 


除了 可 以 选取 图 片 ， 用 户 还 能 通过 图 像 选取 器 用 设备 内 置 的 摄像 头 拍 照 。 由 于 并 非 每 种 jiO3 设 备 都 有 摄像 头 (尤其 是 早期 的 iPod touch 和 iPad 设 备 ) ， 所 以 在 拍照 
之 前 ， 应 该 先 检查 运行 应 用 程序 的 这 台 设 备 是 否 支 持 摄像 头 : 


if ([UIImagePickerController isSourceTypeAvailable: 
UIImagePickerControllerSourceTypeCamera]) 


有 一 条 经 验 就 是 : 决 不 要 在 没有 摄像 头 的 设备 上 面 提供 基于 摄像 头 的 功能 。 虽 说 iOs 7 只 会 部 署 在 带 有 摄像 头 的 设备 上 ， 但 除了 苹果 公司 之 外 ， 谁 也 不 知道 将 来 还 
会 不 会 友 行 没有 摄像 头 的 设备 。 昌 然 听 起 来 不 太 可 能 ， 但 苹果 公司 说 不 定 还 会 太行 没有 摄像 头 的 新 设备 。 如 果 症 果 公司 没有 否认 这 一 点 ， 那 么 即便 在 新 版 的 iOs 中 ， 我 
们 也 依然 得 考虑 到 不 市 摄像 头 的 设备 才 行 。 而 且 ， 我 们 还 得 假定 : 如 果 将 来 系统 里 引入 了 一 些 设 定 ， 能 够 在 市 有 摄像 头 的 设备 上 面 禁 用 某 些 数 据 源 ， 那 么 上 述 方 法 依 

返回 正确 的 结果 


8.3.1 配置 选取 器 


担 照 所 用 的 图 像 选 取 器 的 实例 化 方式 与 选取 普通 图 像 时 所 用 的 选取 器 相似 。 只 需 把 数据 源 的 类 型 从 UllmagePickerControllerSourceTypePhotoLibrary 改 成 


Ullmage-PickerControllerSourceTypeCameraB[In] : 


picker.sourceType = UIImagePickerControllerSourceTypeCamera; 


与 其 他 模式 下 的 图 像 选取 器 类 似 ， 我 们 也 可 以 通过 设置 allowsEditing 属 性 来 允许 或 禁止 用 户 在 拍照 过 程 中 对 图 像 进行 编辑 。 


虽说 用 UllmagePickerControllerSourceTypeCamera 来 配置 图 像 选 取 器 与 用 UllmagePickerControllerSourceTypePhotoLibrary 来 配置 是 相同 的 ， 但 这 二 者 所 
产生 的 用 户 体验 却 略 有 差异 (参见 图 8-2) 。 用 户 点 击 照 相机 图 标 并 拍 好 照片 之 后 ， 图 像 选 取 器 会 展示 出 预 护 (preview) 界面 。 在 该 界面 中 ， 用 户 可 以 重新 拍照 ， 也 
可 以 采用 现在 这 张 照 片 。 如 果 点 击 Use Photo， 那 么 系统 就 会 把 控制 权 交 给 下 一 阶段 的 程序 。 假 如 开启 了 图 像 编辑 功能 ， 那 么 用 户 还 可 以 编辑 图 像 。 如 果 没 开局 这 个 
功能 ， 那 么 控制 权 就 会 转移 给 delegate 中 那个 标准 的 magePickerController: didFinishPickingMediaWithInfo: 方法 。 
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图 8-2 ”用 于 拍照 的 UIImagePickerController， 其 用 户 体验 与 用 于 选取 图 像 的 UIImagePicker Controlletr 有 所 不 同 ， 这 使 得 用 户 可 以 通过 它 来 拍摄 照片 


大 部 分 新 型 设备 都 提供 了 不 只 一 个 摄像 头 。 所 有 能 运行 ijO9s 7 的 设备 都 有 前 后 两 个 摄像 头 。 在 支持 iOS 6 的 设备 之 中 ， 只 有 iPhone 3G9 是 单 摄像 头 。 开 发 者 可 通过 
cameraDevice 属 性 来 设 定 想 要 使 用 的 摄像 头 。 系 统 总 是 默认 使 用 后 置 摄像 头 。 


$7JisCameraDeviceAvailable: 的 类 方法 可 以 查 出 设备 的 某 个 摄像 头 是 否 可 用 。 下 面 这 段 代码 能 够 检测 前 置 摄像 头 是 否 可 用 ， 如 果 可 以 使 用 ， 那 么 就 用 它 来 提 


if ([UIImagePickerController isCameraDeviceAvailable: 
UIImagePickerControllerCameraDeviceFront]) 
picker.cameraDevice - UllmagePickerControllerCameraDeviceFront; 


通过 UllmagePickerController 类 来 使 用 摄像 头 时 ， 还 应 注意 下 面 几 个 问题 : 


: 开发 者 可 通过 名 为 isFlashAvailableForCametaDevice: 的 类 方法 查询 设备 是 否 能 使 用 闪光 灯 。 调 用 该 方法 时 ， 应 该 传 入 与 设备 前 置 摄像 头 或 后 置 摄像 头 相 对 应 的 常 


量 。 如 果 可 以 用 闪光 灯 ， 该 方法 就 返回 YES， 否 则 返回 NO。 


. 如 果 设 备 支持 闪光 灯 ， 那 么 可 以 把 cametraFlashMode 属 性 设置 成 UIImagePicker-ControllerCameraFlashModeAuto (自动 ， 该 值 是 默认 值 ) ~ UllmagePicker- 
ControllerCameraFlashModeOn (总 是 打开 ) 或 UIImagePickerController-CameraFlashModeOff (总 是 关闭 ) 。 禁 用 闪光 灯 之 后 ， 无 论 拍 照 环境 是 瞳 还 是 亮 ， 闪光灯 都 不 会 打 


开 。 


- 开发 者 通过 cametaCaptuteMode 属 性 指定 程序 是 用 摄像 头 来 拍照 还 是 用 它 来 录像 。 图 像 选 取 器 默认 的 模式 是 拍照 。availableCaptufeModesFotrCametaDevice: 方法 可 
以 判断 出 设备 所 支持 的 模式 。 该 方法 返回 的 数组 中 包含 NSNumbet 型 的 对 象 ， 每 个 对 象 的 值 都 表示 设备 所 支持 的 一 种 捕获 模式 : 
UIImagePickerControllerCameraCaptureModePhoto 表 示 拍 照 ，UIImagePickerControllerCameraCaptureModeVideo 表 示 录 像 。 


8.3.2 ”显示 图 像 


处 理 照 片 的 时 候 ， 要 考虑 到 其 图 像 太 斗 。 用 尸 所 担 的 照片 〈 万 其 是 那 种 用 高 分 辨 率 摄像 头 所 担 的 照片 ) 会 非常 大 ， 即 便 在 Retina 显 示 屏 上 也 是 如 此 。 而 前 置 摄像 
头 所 拍照 请 的 分 辨 率 则 比较 低 ， 尺 寸 也 小 得 多 。 


我 们 可 以 在 程序 里 通过 contentMode 来 解决 显示 大 型 图 片 这 一 问题 。 显 示 图 片 的 视图 能 够 将 其 中 的 图 片 缩放 到 与 屏幕 大 小 相符 的 尺寸 。 我 们 可 以 考虑 使 用 下 列 模 
式 : 


: UIViewContentModeScaleAspectFit 模 式 会 在 保持 宽 高 比 不 变 的 情况 下 ， 把 整 幅 图 像 显 示 出 来 。 为 了 保持 宽 高 比 ， 图 像 左右 两 侧 或 上 下 两 端 可 能 会 出 现 空 矩 形 。 


- UIViewContehtModeScaleAspectFil 模 式 尽 可 能 用 图 像 填 满 整个 视图 。 为 了 填 满 视图 ， 有 些 内 容 也 许 会 裁 切 掉 。 


8.3.3 ”把 图 像 保 仔 到 相册 


调用 UllmageWriteToSavedPhotosAlbum0) 函 数 ， 即 可 将 拍 好 的 图 像 (实际 上 可 以 是 任意 的 Ullmage 实 例 ) 保存 到 相册 。 该 函数 接受 四 个 参数 。 第 一 个 参数 表示 
待 存 的 图 像 。 第 二 与 第 三 个 参数 分 别 是 回调 的 目标 以 及 回调 的 选择 子 ， 这 两 者 通常 是 主 视图 控制 器 以 及 image: didFinishSavingWithError: contextInfo: 。 第 四 个 
参数 是 可 选 的 ， 它 是 个 指向 上 下 文 的 指针 。 无 论 采 用 哪 种 选择 子 ， 这 个 选择 子 都 必须 接受 三 个 参数 ， 它 们 分 别 表示 图 像 、 错 误 以 及 指向 传 入 的 上 下 文 信息 的 指针 。 


解决 方案 8-2 采 用 UllmageWriteToSavedPhotosAlbum0 函 数 来 演示 如 何 提 摄 新 图 像 、 如 何 允 许 用户 编 辑 图 像 以 及 怎样 把 图 像 保存 到 相册 。 


解决 方案 8-2 ”拍摄 照片 


// "Finished saving" callback method 

- (void)image: (UIImage *)image 
didFinishSavingWithError: (NSError *)error 
contextInfo: (void *)contextInfo; 


// Handle the end of the image write process 
if (lerror) 
NSLog(G"Image written to photo album"); 
else 
NSLog(G"Error writing to photo album: %@", 
error.localizedFailureReason); 


// Save the returned image 
- (void)imagePickerController: (UIImagePickerController *)picker 
didFinishPickingMediaWithInfo: (NSDictionary *)info 


// Use the edited image if available 
UIImage _autoreleasing *image = 
info[UIImagePickerControllerEditedImage]; 


// If not, grab the original image 
if (!image) 


image = info[UIImagePickerControllerOriginalImage]; 


// If still no luck, check for an asset URL 

NSURL *assetURL - info[UIImagePickerControllerReferenceURL]; 
if (!image && !assetURL) 

{ 


NSLog(G"Cannot retrieve an image from selected item. Giving up."); 


| 


else if (!image) 
{ 


NSLog(G"Retrieving from Assets Library"); 
[self loadImageFromAssetURL:assetURL into: &image] ; 


if (image) 
{ 
// Save the image 
UIImageWriteToSavedPhotosAlbum(image, self, 
Gselector(image:didFinishSavingWithError:contextInfo:), 
NULL); 
imageView.image - image; 


[self performDismiss]; 


- (void)loadView 


{ 


self.view = [[UIView alloc] init]; 
self.view.backgroundColor = [UIColor whiteColor] ; 
imageView = [[UIImageView alloc] init]; 


imageView.contentMode = UIViewContentModeScaleAspectFit; 
[self.view addSubview:imageViewl; 

PREPCONSTRAINTS (imageView); 

STRETCH VIEW(self.view, imageView); 


// Only present the "Snap" option for camera-ready devices 
if ([UIImagePickerController isSourceTypeAvailable: 
UIImagePickerControllerSourceTypeCamera]) 
self.navigationlItem.rightBarButtonItem = 
SYSBARBUTTON (UIBarButtonSystemItemCamera, 
Gselector(snaplImage))); 


// Set up title view with Edits: ON/OFF 
editSwitch = [[UISwitch alloc] init]; 
UILabel * editLabel = 
[[UILabel alloc] initWithFrame:CGRectMake(0, 0, 40, 13)]; 
editLabel.text = @"Edits"; 
self.navigationItem.leftBarButtonItems - 
&e[[[UIBarButtonlItem alloc] initWithCustomView:editLabel], 
[[UIBarButtonItem alloc] initWithCustomView:editSwitch]]; 


8.4 解决 万 案 : Sem 


虽说 在 iOS 7 时 代 很 多 设备 都 市 了 摄像 头 ， 但 我 们 还 是 得 判断 运行 程序 的 这 人 台 设 备 到 底 有 没有 摄像 头 ， 此 外 ， 还 要 判断 摄像 头 的 类 型 。 录 制 视 频 忆 前， 应 用 程序 应 
该 先 检 查 设备 是 否 支 持 基于 摄像 头 的 视频 录制 |。 


这 个 过 程 要 分 两 步 执行 。 只 检测 设备 有 没有 摄像 头 是 不 够 的 ， 因 为 第 一 代 iPhone 及 iPhone 3G 虽 然 有 摄像 头 ， 但 却 没有 录制 视频 的 功能 (早期 iPad 与 iPod touch 
设备 根本 融 没 有 摄像 头 ) ， 只 有 3G3 及 后 续 机 型 才 可 以 录制 视频 。 虽 说 不 太 可 能 ， 但 苹果 公司 将 来 没 佳 还 会 推出 市 有 摄像 头 却 只 能 拍摄 静态 照片 的 机 型 。 


于 是 ， 我 们 必须 执行 两 次 检测 : 首先 判断 设备 有 没有 摄像 头 ， 然 后 判断 可 以 捕获 的 媒体 类 型 里 面 有 没有 “视频 ”这 一 项 。 下 列 万 法 返回 的 布尔 值 用 来 表示 运行 程 
序 的 设备 能 不 能 拍摄 视频 : 


- (BOOL) videoRecordingAvailable 


| 


// The source type must be available 
if (![UIImagePickerController isSourceTypeAvailable: 
UIImagePickerControllerSourceTypeCamera]) 


return NO; 


// And the media type must include the movie type 

NSArray *mediaTypes - [UIImagePickerController 
availlableMediaTypesForSourceType: 
UIImagePickerControllerSourceTypeCamera] 

return [mediaTypes containsObject: (NSString *)kUTTypeMovie]; 


上 述 方法 会 查询 设备 所 支持 的 媒体 类 型 ， 然 后 在 查询 结果 里 搜寻 表示 视频 的 那 种 类 型 (kUTTypeMovie, tbzepublic.movie) 。 统 一 类 型 标识 符 (Uniform 
Type Identifier, RUTI) 是 一 种 描述 抽象 类 型 的 字符 串 ， 用 来 指 代 图 像 、 影 片 及 数据 等 常用 的 文件 格式 。 第 11 章 将 会 详 述 UTI。 由 于 这 些 类 型 定义 于 Mobile Core 
Services 模 块 之 中 ， 所 以 在 源 文件 里 需要 引入 该 模块 : 


@import MobileCoreServices; 


8.4.1 创建 录制 视频 用 的 选取 器 


用 摄像 头 来 录制 视频 与 用 它 来 担 摄 静态 照片 是 一 样 的。 解决 方案 8-3 新 建 并 初始 化 了 一 个 UllmagePickerController， 然 后 设置 它 的 delegate， 并 将 其 展示 出 来 : 


UIImagePickerController *picker = 

[[UIImagePickerController alloc] init]; 
picker.sourceType - UIImagePickerControllerSourceTypeCamera; 
picker.videoQuality = UlImagePickerControllerQualityTypeMedium; 
picker.mediaTypes = @[(NSString *)kUTTypeMovie]; // public.movie 
picker.delegate - self; 


开发 者 可 以 指定 视频 的 录制 质量 。 视 频 质 量 越 高 ， 每 秒 钟 所 产生 的 数据 量 就 越 大 。 我 们 可 以 选择 UllmagePickerControllerQualityTypeHigh (高 质量 ) 、 
UllmagePicker-ControllerQualityTypeMedium (中 等 质量 ) 、UllmagePickerControllerQuality-TypeLow ( 低 质 量 ) 或 


UllmagePickerControllerQualityType640x480 (VGA) , 
与 选取 图 片 时 一 样 ， 我 们 也 可 以 在 拍摄 视频 所 用 的 选取 器 上 面 设置 allowsEditing 属 性 ， 解 决 方案 8-5 将 会 讲解 该 属性 。 


解决 方案 8-3 ”录制 视频 


- (void)video: (NSString *)videoPath 
didFinishSavingWithError: (NSError *)error 
contextInfo: (void *)contextInfo 


if (!error) 
self.title = @"Saved!"; 
else 
NSLog(@"Error saving video: %@", 
error.localizedFailureReason) ; 


- (void) saveVideo: (NSURL *)mediaURL 
| 
// check if video is compatible with album 
BOOL compatible - 
UIVideoAt PathIsCompatibleWithSavedPhotosAlbum ( 
mediaURL.path) ; 


// save 
if (compatible) 
UISaveVideoAt PathToSavedPhotosAlbum ( 
mediaURL.path, self, 
@selector (video: didFinishSavingWithError:contextInfo:), 
NULL) ; 


- (void) imagePickerController: (UIImagePickerController *) picker 
didFinishPickingMediaWithInfo: (NSDictionary *) info 


[self performDismiss]; 


// Save the video 

NSURL *mediaURL - 
info[UIImagePickerControllerMediaURL]; 

[self saveVideo: mediaURL] ; 


- (void)recordVideo 


| 


if (popover) return; 
self.title - nil; 


// Create and initialize the picker 
UIImagePickerController *picker - 

[[UIImagePickerController alloc] init]; 
picker.sourceType - UIImagePickerControllerSourceTypeCamera; 
picker.videoQuality = UllImagePickerControllerQualityTypeMedium; 
picker.mediaTypes = @[(NSString *)kUTTypeMovie] ; 
picker.delegate = self; 


[self presentViewController:picker] ; 


8.4.2 CERA 


视频 选取 器 所 返回 的 信息 字典 (info dictionary) 里 面 含 有 名 为 UllmagePicker ControllerMediaURL 的 键 ， 该 键 所 对 应 的 媒体 URL 指 向 录制 好 的 视频 ， 此 视频 存 
放 于 应 用 程序 沙 使 (app sandbox) 里 的 临时 文件 夹 中 。 我 们 可 以 用 UlsaveVideoAtPathTosavedPhotosAlbum(0 函 数 将 视频 保存 到 媒体 库 。 


保存 视频 用 的 消 数 接受 四 个 参数 : 视频 在 媒体 库 中 的 保存 路 径 、 回 调 的 目标 、 回 调 的 选择 子 (这 个 选择 子 接受 三 个 参数 ， 与 保存 图 片 时 所 指定 的 那个 回调 选择 子 
基本 相同 ) 以 及 可 选 的 上 下 文 。 此 消 数 执行 完 任 务 之 后 ， 会 在 目标 上 面 调 用 选择 子 ， 使 得 开发 者 可 以 检查 任务 有 没有 执行 成 功 。 


8.5 解决 方案 : 用 媒体 播放 器 播放 视频 


MPMoviePlayerViewController 类 及 MPMoviePlayerController 类 简化 了 应 用 程序 中 的 视频 播放 。 这 些 类 是 Media Player 框 架 的 一 部 分 ， 它 们 使 得 开发 者 可 以 把 
视频 嵌入 到 视图 之 中 ， 或 是 在 全 屏 模 式 下 播放 视频 。 图 8-3 演 示 了 系统 预 置 的 视频 播放 器 ， 这 个 播放 器 的 功能 比较 完备 ， 开 发 者 只 需 提 供 指 向 视频 内 容 的 URL 即 可 。 播 
放 器 提供 有 Done 按 钮 、 时 间 滚 动 条 、 宽 高 比 控制 按钮 、 回 放 控 件 ， 并 且 会 把 视频 内 容 展示 在 这 些 控件 后 方 。 


1:28 AM 


pun 


图 8-3 Media Playet 框 架 简化 了 应 用 程序 的 视频 回放 。 这 个 类 既 可 以 播放 设备 之 外 的 串 流 视频 ， 也 可 以 播放 存储 在 本 机 的 固定 视频 资源 。 支 持 的 视频 格式 包括 
H.264Baseline Profile Level 3.0 视 频 (每 秒 最 多 30 帧 ， 每 帧 最 大 640X480) 以 及 MPEG-4Part 2 视频 (Simple Profile) 。 以 .mov、.mp4、.mpv 及 .3gp 为 扩展 名 的 大 部 分 文件 都 


可 以 播放 。 支 持 的 音频 格式 包括 AAC-LC 音 频 (采样 率 最 大 48KHz) 以 及 MP3 (MPEG-lAudio Layer 3， 采 样 率 最 大 48KHz) ZAP 


我 们 在 解决 方案 8-3 里 构建 了 视频 录制 功能 ， 解 决 方案 8-4 是 基于 解决 方案 8-3 而 编写 的 。 每 次 录 完 视频 之 后 ， 它 会 把 导航 栏 上 的 Camera 按 钮 切换 成 Play 按钮 ， 以 
便 回 放 视 频 。 这 条 解决 方案 没有 把 视频 保存 到 媒体 库 中 ， 用 户 可 以 反复 地 录制 并 播放 视频 。 


解决 方案 8-4 ”视频 回放 


#define SYSBARBUTTON(ITEM, SELECTOR) [[UIBarButtonItem alloc] \ 
initWithBarButtonSystemItem:ITEM target:self action:SELECTOR] 


- (void)playMovie 
| 
// Prepare movie player and play 
MPMoviePlayerViewController *player - 
[(MPMoviePlayerViewController alloc] 
initWithContentURL:mediaURL] ; 
player.moviePlayer.allowsAirPlay = YES; 
player.moviePlayer.controlStyle = MPMovieControlStyleFullscreen; 


[self .navigationController 
presentMoviePlayerViewControllerAnimated:player] ; 


// Handle the end of movie playback 
[[NSNotificationCenter defaultCenter] 
addObserverForName:MPMoviePlayerPlaybackDidFinishNotification 
object:player.moviePlayer queue: [NSOperationQueue mainQueue] 
usingBlock:^(NSNotification *notification) { 
// Return to recording mode 
self .navigationItem.rightBarButtonItem = 


SYSBARBUTTON (UIBarButtonSystemItemCamera, 
Gselector(recordVideo)); 
// Stop listening to movie notifications 
[[NSNotificationCenter defaultCenter] 
removeObserver:self]; 


1; 


// Wait for the movie to load and become playable 

[[NSNotificationCenter defaultCenter] 
addObserverForName:MPMoviePlayerLoadStateDidChangeNotification 
object:player.moviePlayer queue: [NSOperationQueue mainQueue] 
usingBlock:^(NSNotification *notification) { 


// When the movie sets the playable flag, start playback 
if ((player.moviePlayer.loadState & 
MPMovieLoadStatePlayable) !- 0) 
[player.moviePlayer performSelector:@selector (play) 
withObject:nil afterDelay:1.0f]; 


Hs 


// After recording any content, allow the user to play it 
- (void)imagePickerController: (UIImagePickerController *)picker 
didFinishPickingMediaWithInfo: (NSDictionary *)info 


[self performDismiss]; 


// recover video URL 
mediaURL = info[UIImagePickerControllerMediaURL]; 
self.navigationItem.rightBarButtonItem - 
SYSBARBUTTON (UIBarButtonSystemItemPlay, 
Gselector(playMovie)); 


图 像 选取 器 提供 了 视频 媒体 的 URL， 我 们 只 需 通 过 这 个 URL， 就 能 建立 播放 器 。 解 决 方案 8-4 实 例 化 了 一 个 新 的 播放 器 ， 并 设置 了 它 的 两 个 属性 。 首 先 激活 
AirPlay， 使 手机 可 以 把 录 好 的 视频 捉 流 到 带 AirPlay 功 能 的 接收 方 那里 ， 比 如 苹果 公司 的 TV 或 Reflector (http://reflectorapp.com/) 等 商业 软件 。 然 后 设置 回放 风 
格 ， 令 视频 以 全 屏 状态 播放 。 接 下 来 把 视频 显示 出 来 。 


组 成 视频 播放 器 的 两 个 类 中 ， 有 一 个 是 可 以 展示 出 来 的 视图 控制 器 (MPMoviePlayerView-Controller) ， 另 一 个 则 是 实际 的 播放 控制 器 
(MPMoviePlayerController) ， 前 者 会 把 后 者 放 在 自己 的 一 个 属性 里 面 。 这 就 是 解决 方案 8-4 中 多 次 提 到 player.moviePlayer 的 原因 。 视 图 控制 器 类 非常 小 ， 而 且 易 
于 启动 。 真 正 的 工作 是 在 播放 控制 器 里 完成 的 。 


视频 播放 器 采用 通知 机 制 与 应 用 程序 相通 信 ， 而 不 采用 委托 。 开 友 者 可 以 通过 订阅 通知 来 获知 视频 何 时 开始 播放 、 何 时 播放 完毕 以 及 何 时 改变 状态 (比方 说 从 暂 
字 状 态 变 为 播放 状态 ) 。 解 决 方案 8-4 订 阅 了 两 种 通知 ， 用 来 监测 什么 时 候 可 以 播放 视频 以 及 视频 什么 时 候 播放 完毕 。 


等 视频 加 载 进 来 并 且 状 态 变 为 可 以 播放 之 后 ， 解 决 方案 8-4 束 开始 回放 该 视频 。 程 序 会 进入 全 屏 状 态 ， 并 持续 播放 视频 ， 直 到 用 户 点 击 Done 按 钮 或 视频 播放 完毕 
为 止 。 在 这 两 种 情况 下 ， 播 放 器 都 会 产生 播放 完毕 的 通知 。 此 时 ， 应 用 程序 会 返回 录制 模式 ， 并 显示 出 Camera 按 钮 ， 使 得 用 户 可 以 录制 下 一 段 视 频 。 


这 条 解决 方案 演示 了 人 在 iOs 系 统 里 播放 视频 所 需 的 基本 代码 。 程 序 不 一 定 非 要 播放 用 户 上 自己 录制 的 视频 ，MPMoviePlayerController 没 有 限制 视频 的 来 源 。 你 可 以 
把 contentURL 设 为 沙 箱 中 的 某 个 文件 ， 也 可 以 令 其 指向 互联 网 上 某 个 能 够 播放 出 来 的 视频 资源 。 


Qi 如 果 视 频 播 放 器 刚 一 打开 就 立刻 关闭 了 ， 那 么 请 检查 URL 是 否 正 确 。 别 忘 了 ， 指 向 本 地 文件 的 URL 应 该 用 feURLWithPath: 方法 来 创建 ， 而 指向 远程 资 
源 的 URIL 则 应 该 以 URLWithString: 来 制作 。 


8.6 解决 方案 : 编辑 视频 


如 果 图 像 选取 器 的 媒体 来 源 是 一 段 视频 ， 那 么 在 局 用 了 allowsEditing 属 性 之 后 ， 融 会 看 到 一 条 黄 颜 色 的 编辑 栏 ， 它 与 内 置 的 Photos 程 序 所 显示 的 编辑 栏 是 一 样 
的 。 ( 拖 动 编辑 栏 左 右 两 器 的 提示 按钮 ， 即 可 看 到 这 种 效果 。) HX SR, BPRS EA aim, Re BAC. 
奇怪 的 是 ，UllmagePickerController 并 不 会 直接 剪辑 当前 的 视频 ， 而 是 返回 包含 下 列 四 个 项 目的 信息 字典 : 


: UIImagePickerControllerMediaURL 
: UlImagePickerControllerMediaType 
. UIImagePickerControllerVideoEditingStartt 


:  UllImagePickerControllerVideoEditingEnd 
RURKA MRBIN, ZAR ERE PAVIA M ESEEB, RAE Ra SE RABBRINSNumber(Esixzn, li Jat FH 71 Gee A ABT- HATS 


定 的 偏 移 量 。 媒 体 类 型 是 public.movie。 
如 果 把 视频 保存 到 媒体 库 ( 像 解决 方案 8-3 那 样 ) ， 那 么 保存 的 将 是 没有 和 甬 辑 过 的 版 本 ， 这 并 不 是 用 户 想 要 的 效果 。iOSs SDK 提 供 了 两 种 编辑 视频 的 方式 。 解 决 方 
案 8-5 将 会 演示 如 何 用 AV Foundation 框 架 来 响应 视频 编辑 请 求 ， 以 便 和 剪辑 由 UllmagepPickerController 所 返回 的 视频 。 解 决 方案 8-6 将 要 演示 怎样 从 媒体 库 中 选取 视 


频 ， 并 使 用 UIVideoEditor-Controller 来 编辑 这 些 视 步 


=H EH 


解决 方案 8-5 AAV Foundation 框 架 来 剪辑 视频 


| 


(void)trimVideo: (NSDictionary *)info 


// xecover video URL 


NSURL *mediaURL = 


info [UIImagePickerControllerMediaURL] ; 
AVURLASSet *asset = 
[AVURLAsset URLAssetWithURL:mediaURL options:nil]; 


// Create the export range 
CGFloat editingStart - 
[info [@" UIImagePickerControllerVideoEditingStart"] 
floatValue]; 
CGFloat editingEnd - 
[info[@" UIImagePickerControllerVideoEditingEnd"] 
floatValue]; 
CMTime startTime = CMTimeMakeWithSeconds(editingStart, 1); 
CMTime endTime = CMTimeMakeWithSeconds (editingEnd, 1); 
CMTimeRange exportRange - 
CMTimeRangeFromTimeToTime(startTime, endTime) ; 


// Create a trimmed version URL: file:originalpath-trimmed.mov 

NSString *urlPath = mediaURL.path; 

NSString *extension = urlPath.pathExtension; 

NSString *base = [urlPath stringByDeletingPathExtension] ; 

NSString *newPath = [NSString stringWithFormat: 
@"$@-trimmed.%@", base, extension]; 

NSURL *fileURL = [NSURL fileURLWithPath:newPath]; 


// Establish an export session 
AVAssetExportSession *session - [AVAssetExportSession 
exportSessionWithAsset:asset 
presetName:AVAssetExportPresetMediumQuality]; 
session.outputURL - fileURL; 
session.outputFileType - AVFileTypeQuickTimeMovie; 
session.timeRange - exportRange; 


// Perform the export 
[session exportAsynchronouslyWithCompletionHandler:^()( 
if (session.status -- 
AVAssetExportSessionStatusCompleted) 
[self saveVideo:fileURL]; 
else if (session.status -- 
AVAssetExportSessionStatusFailed) 
NSLog(@"AV export session failed"); 
else 


NSLog(G"Export session status: $d", session.status); 


Hl; 


AV Foundation% Core Media 框 架 


这 条 解决 方案 需要 访问 两 个 功能 非常 专业 的 模块 。AV Foundation 模 块 提 供 了 一 套 Objective-C 语 言 的 接口 ， 用 来 处 理 媒体 人 资源。 而 Core Media 则 采用 一 套 底层 
的 C 语 言 接口 来 描述 媒体 的 属性 。 把 这 二 者 结合 起 来 ， 就 能 在 iOS 上 面 实现 出 与 Mac 的 QuickTime 相 仿 的 媒体 播放 效果 了 。 我 们 在 本 条 解决 方案 的 源 文 件 中 引入 这 两 个 
模块 。 


解决 方案 8-5 首 先 从 图 像 选取 器 所 返回 的 信息 字典 里 获取 媒体 的 URL。 这 个 URL 指 向 沙 使 中 的 临时 文件 ， 访 文件 是 由 图 像 选 取 器 所 创建 的 。 这 条 解决 方案 会 根据 媒 
体 的 URL 来 新 建 AV 资 源 URL (AV asset URL) 。 然 后 ， 它 要 创建 导出 范围 ， 凡 是 位 于 此 范围 中 的 视频 内 容 都 应 该 保存 到 媒体 库 里 。 为 了 创建 这 个 范围 ,我们 需要 用 信 
息 字典 中 的 起 始 时 | 间 和 终止 时 间 来 构建 Core Media 框 架 中 的 CMTimeRange 结 构 体 。CMTimeMakeWithSeconds0 函 数 接受 两 个 参数 : 时 间 与 缩放 倍数 。 为 了 确保 
精确 的 剪辑 时 间 ， 本 条 解决 方案 将 缩放 倍数 设 为 1。 


应 用 程序 可 以 通过 AVAssetExportSession 把 数据 存 回 文件 系统 。 这 个 session 并 不 会 将 视频 存 入 媒体 库 ， 而 是 通过 另外 一 个 步骤 来 完成 。 这 个 session 会 把 剪辑 过 
的 视频 以 本 地 文件 的 形式 保存 到 沙 箱 中 的 临时 文件 夹 里 ， 并 与 用 户 所 拍摄 的 原始 视频 文件 放 在 一 起 。 在 创建 AVAssetExportSession 的 时 候 ， 我 们 要 设置 资源 和 导出 品 
质 。 


解决 方案 8-5 会 把 剪辑 过 的 视频 保存 到 新 的 路 径 中 。 这 条 路 径 与 读 入 资源 时 所 用 的 路 径 相同 ， 只 不 过 文件 名 后 面 会 多 出 来 “-trimmed” 字 样 。 我 们 把 新 路 径 设 为 
AVAssetExportSession 的 outputURL， 并 采用 exportRange 里 面 所 指定 的 起 止 时 间 来 导出 视频 ， 同 时 ， 还 把 导出 视频 的 类 型 设置 成 AVFileTypeQuickTimeMovie。 现 
在 可 以 开始 处 理 视频 文件 了 。AVAssetExportSession 会 以 异步 的 方式 执行 文件 导出 操作 ， 它 所 使 用 的 媒体 属性 及 媒体 内 容 都 是 由 我 们 传 给 它 的 资源 所 决定 的 。 


剪辑 完 视 频 后 ， 我 们 将 其 存 入 设备 的 中 央 媒 体 库 。 解 决 万 案 8-5 把 保存 视频 文件 所 用 的 代码 放 在 块 里 ，AVAssetExportSession 会 在 执行 完 导出 操作 之 后 ， 运 行 该 
块 中 的 代码 。 


8.7 ”解决 方案 : 选取 并 编辑 倪 频 


你 可 以 像 选 取 图 像 时 那样 ， 用 UllmagePickerController 来 选取 视频 ， 解 决 方案 8-6 演 示 了 这 一 功能 。 我 们 只 需要 稍微 修改 一 下 mediaTypes 属 性 即 可 。 
sourceType 还 是 像 原来 那样 设置 ， 但 这 次 要 限定 mediaTypes 属 性 。 下 面 这 段 代 码 演示 了 怎样 设置 mediaTypes 才 能 令 UllmagePickerController 只 显示 视频 资源 : 


picker.sourceType 


UIImagePickerControllerSourceTypePhotoLibrary; 


I 


picker.mediaTypes = @[(NSString *)kUTTypeMovie]; 


用 户 选 定 某 个 视频 之 后 ， 解 决 方案 8-6 便 进入 编辑 模式 。 要 记得 检查 这 个 视频 资源 能 不 能 修改 。 我 们 调用 UIVideoEditorController 的 类 方法 
canEditVideoAtPath: 。 该 方法 返回 的 布尔 值 用 来 表示 视频 是 否 与 UIVideoEditorController 相 兼容 : 


if (![UIVideoEditorController canEditVideoAtPath:vpath]) 


如 果 待 修改 的 视频 能 够 与 UIVideoEditorController 相 兼容 ， 那 么 束 新 建 视频 编辑 器 。UIVideoEditorController 类 中 包含 了 一 套 由 系统 提供 的 界面 ， 使 得 用 户 可 以 
交互 式 地 剪辑 视频 。 我 们 设置 好 它 的 delegate 及 videoPath 属 性 ， 并 将 其 展示 出 来 。 (经 由 videoQuality 属 性 ， 开 上 友 者 也 能 通过 这 个 类 将 视频 重新 编码 成 质量 较 低 的 格 
zb ) 


视频 编辑 器 所 用 的 delegate 回 调 与 UllmagePickerController 类 相似 ， 但 并 不 完全 相同 。 这 些 回调 方法 分 别 用 来 处 理 “ 成 功 ”、“ 失 败 ” 以 及 “取消 ”这 三 种 情 
iR: 


- videoEditorController: didSaveEditedVideoToPath: 
: videoEditorController: didFailWithErtror: 


- videoEditorControllerDidCancel : 


只 有 当 用 户 点 击 视 频 编 辑 器 中 的 Cancel 按 钮 时 ， 才 会 触 帮 “取消 ”操作 。 要 是 在 popover 池 围 之 外 点 击 ， 则 会 直接 把 视频 编辑 器 关 掉 ， 这 时 不 会 触发 回调 方法 。 
如 果 用 户 取 消 了 操作 ， 或 是 UIVideoEditorController 无 法 处 理 视频 ， 那 么 解决 方案 8-6 就 会 重 置 其 界面 ， 使 得 用 户 可 以 选取 另 一 个 视频 。 


解决 方案 8-6 ”用 UIVideoEditorController 编 辑 视频 


// The edited video is now stored in the local tmp folder 
- (void)videoEditorController: (UIVideoEditorController *)editor 
didSaveEditedVideoToPath: (NSString *)editedVideoPath 


[self performDismiss] ; 


// Update the working URL and present the Save button 
mediaURL = [NSURL URLWithString:editedVideoPath] ; 
self .navigationItem.leftBarButtonItem = 

BARBUTTON (@"Save", Gselector(saveVideo)); 
self .navigationItem.rightBarButtonItem = 

BARBUTTON (@"Pick", @selector(pickVideo) ) ; 


// Handle failed edit 
- (void) videoEditorController: (UIVideoEditorController *) editor 
didFailWithError: (NSError *) error 


[self performDismiss] ; 
mediaURL = nil; 
self.navigationItem.rightBarButtonItem = 
BARBUTTON (G"Pick", Gselector(pickVideo)); 
self.navigationItem.leftBarButtonItem - nil; 
NSLog(G"Video edit failed: $0", error.localizedFailureReason); 


// Handle cancel by returning to Pick state 
- (void)videoEditorControllerDidCancel: 
(UIVideoEditorController *)editor 


[self performDismiss]; 


mediaURL - nil; 

self.navigationItem.rightBarButtonItem = 
BARBUTTON(G"Pick", Gselector(pickVideo)); 

self .navigationItem.leftBarButtonItem = nil; 


// Allow the user to edit the media with a video editor 
- (void)editMedia 


| 


if (![UIVideoEditorController canEditVideoAtPath:mediaURL.path]) 


| 


self.title - e"Cannot Edit Video"; 
self.navigationItem.rightBarButtonItem - 

BARBUTTON (@"Pick", Gselector(pickVideo)); 
return; 


UIVideoEditorController *editor = 
[[UIVideoEditorController alloc] init); 

editor.videoPath - mediaURL.path; 

editor.delegate - self; 

[self presentViewController:editor]; 


// The user has selected a video. Offer an edit button. 
- (void)imagePickerController: (UIImagePickerController *) picker 
didFinishPickingMediaWithInfo: (NSDictionary *)info 


[self performDismiss] ; 


// Store the video URL and present an Edit button 


mediaURL = info[UIImagePickerControllerMediaURL]; 
self .navigationItem.rightBarButtonItem = 
BARBUTTON (@"Edit", @selector (editMedia) ) ; 


当 用 户 编辑 完毕 并 按 下 Use 按 钮 时 ， 系 统 会 触发 表示 “成功 ”的 那个 回调 方法 。UIVideoEditorController 会 把 剪辑 过 的 视频 保存 到 临时 路 径 ， 并 调用 
videoEditorController: didSaveEditedVideoToPath: 方法 。 但 这 并 不 等 于 说 直接 把 视频 保存 到 照片 库 ， 因 为 这 条 路 径 位 于 应 用 程序 沙 盒 的 临时 文件 夹 中 。 如 果 我 
们 不 处 理 这 份 数据 ， 那 么 设备 下 次 重启 的 时 候 ，iOS3 就 会 将 其 删除 。 经 过 这 一 步 之 后， 解决 方案 8-6 会 提供 一 个 按钮 ， 用 来 把 剪辑 过 的 视频 保存 到 共享 的 iOS 相 册 里 ， 保 
存 视频 所 用 的 技术 与 解决 方案 8-3 相 同 。 


8.8 解决 方案 : 通过 电子 邮件 友 进 图 片 


Message UI 框架 使 得 用 户 可 以 在 程序 中 编写 电子 邮件 及 文本 消息 。 与 通过 Ullmage PickerController 来 使 用 摄像 头 的 时 候 一 样 ， 在 使 用 这 些 功能 之 前 ， 也 要 先 判 
断 用 户 的 设备 是 否 文 持 这 些 服 务 。 下 面 这 条 简单 的 测试 语句 能 够 判断 出 设备 是 否 可 以 友 送 邮件 : 


[MFMailComposeViewController canSendMail] 


如 果 设 备 启 用 了 邮件 功能 ， 那 么 用 户 就 可 以 通过 MFMailComposeViewController 实 例 来 发 送 照 片 了 。 文 本 消息 则 是 通过 MFMessageComposeViewController 
实例 友 送 的 。 


解决 方案 8-7 用 MFMailComposeViewController 类 来 创建 新 的 邮件 ， 并 把 用 户 所 拍照 片 放 入 其 中 。 在 iPhone 及 iPad 设 备 上 面 ， 最 好 能 够 以 模 态 界面 的 形式 来 展 
示 MFMailComposeViewController。 我 们 用 主 视图 控制 器 将 它 展示 出 来 之 后 ， 可 通过 委托 回调 来 接收 用 户 的 操作 结 


解决 方案 8-7 ”通过 电子 邮件 友 送 图 像 


- (void)mailComposeController: 
(MFMailComposeViewController*)controller 
didFinishWithResult: (MFMailComposeResult)result 
error: (NSError*)error 


// Wrap up the composer details 
[self performDismiss]; 
switch (result) 
| 
case MFMailComposeResultCancelled: 
NSLog(G"Mail was cancelled"); 
break; 
case MFMailComposeResultFailed: 
NSLog(G"Mail failed"); 
break; 
case MFMailComposeResultSaved: 
NSLog(G"Mail was saved"); 
break; 
case MFMailComposeResultSent: 
NSLog(G"Mail was sent"); 
break; 
default: 
break; 


- (void)sendImage 
UIImage *image - imageView.image; 
if (!image) return; 


// Customize the e-mail 

MFMailComposeViewController *mcvc - 
[[MFMailComposeViewController alloc] init]; 

mcvc.mailComposeDelegate - self; 


// Set the subject 
[ncvc setSubject:G"Here's a great photo!"]; 


// Create a prefilled body 

NSString *body = G"«hl»Check this out«/h1»^ 

«p»I snapped this image from the^ 
<code><b>UIImagePickerController</b></code>.</p>"; 
[ncvc setMessageBody:body isHTML:YES] ; 


// Add the attachment 
[ncvc addAttachmentData:UIImageJPEGRepresentation(image, 1.0f) 


mimeType:G"image/jpeg" fileName:G"pickerimage.jpg"]; 


// Present the e-mail composition controller 
[self presentViewController:mcvc]; 


创建 消息 内 容 


通过 MFMailComposeViewController 的 各 项 属性 ， 我 们 可 以 用 编程 的 方式 来 构建 包含 to/cc/bcc recipients (直接 收 件 人 / 抄 送 收 件 人 / 密 件 抄 送 收 件 人 ) 与 附件 


的 邮件 消息 。 解 决 方案 8-7 演 示 了 如 何 创建 市 附件 的 简单 HTML 消 息 。 这 些 属性 基本 上 都 是 可 选 的 。 开 有 友 者 可 通过 setSubject: &setMessageBody: 来 定义 邮件 主题 
及 正文 。 这 两 个 方法 都 接受 一 个 字符 串 作 为 参数 。 


若是 不 指定 收 件 人 ， 用 户 则 会 看 到 一 封 不 含 收 件 地 址 的 邮件 消息 。 有 时候 可 能 需要 预先 填 好 收 件 地 址 ， 比 方 说 ， 在 实现 Report a Bug (报告 程序 错误 ) 或 Seed 
Feedback (上 友 送 反馈 ) 等 需要 联系 软件 开 友 者 的 功能 时 ， 融 需要 这 样 做 ， 此 外 ， 如 果 程 序 允 许 用 户 从 音 用 的 收 件 人 中 提前 选 好 邮件 的 接收 方 ， 那 么 开 友 者 也 需要 这 样 
做 。 


创建 附件 融 要 稍微 复杂 一 点 了 。 各 想 添 加 附件 ， 我 们 必须 提供 邮件 客户 端 所 需 的 全 部 文件 信息 ， 包 括 数据 (经 由 NSData 对 象 提供) 、MIME 类 型 (经 由 字符 串 来 
提供 ) 以 及 文件 名 〈 经 由 另外 一 个 字符 串 来 提供 ) 。UllmageJPEGRepresentation() 函 数 可 用 来 获取 图 像 数 据 。 该 函数 可 能 要 花 些 时 间 才 能 获取 到 数据 ， 所 以 ， 在 显 
示 出 邮件 消息 界面 之 前 ， 可 能 会 稍 有 延迟 。 


本 条 解决 方案 把 MIME 类 型 直接 以 硬 代码 的 形式 写成 Image/jpeg。 如 果 要 发 送 其 他 类 型 的 数据 ， 那 么 请 通过 常用 的 文件 扩展 名 向 iOS 查 询 与 之 对 应 的 MIME 类 型 。 
下 面 这 个 方法 使 用 Mobile Core Services 框 架 中 的 UTTypeCopyPreferredTagWithClass() 函 数 来 实现 此 功能 : 


#import <MobileCoreServices/UTType.h> 
- (NSString *) mimeTypeForExtension: (NSString *) ext 


| 


// Request the UTI for the file extension 

CFStringRef UTI = UTTypeCreatePreferredIdentifierForTaqg( 
kUTTagClassFilenameExtension, 
( bridge CFStringRef) ext, NULL); 

1r (QUTI) retum nil; 


// Request the MIME file type for the UTI, 

// may return nil for unrecognized MIME types 

NSString *mimeType = (_ bridge transfer NSString *) 
UTTypeCopyPreferredTagWithClass (UTI, kUTTagClassMIMEType) ; 

CFRelease (UTI): 

return mimeType; 


上 述 方法 会 根据 传 入 的 文件 扩展 名 返回 标准 的 MIME 类 型 ， 开 发 者 可 以 传 入 jpg、.png、.txt、.html 等 扩展 名 。iOSs 内 置 了 一 份 扩展 名 与 MIME 类 型 之 间 的 对 应 关 
系 库 ， 但 由 于 其 中 的 数据 比较 有 限 ， 所 以 开 友 者 要 记得 判断 mimeTypeForExtension: 方法 的 返回 值 是 不 是 nil。 还 有 一 种 办 法 融 是 上 网 查找 相应 的 MIME 类 型 ， 然 后 
手动 将 其 添加 到 项 目 里 。 


通过 电子 邮件 发 送 数 据 时 ， 开 发 者 要 给 这 份 数据 起 个 文件 名 ,选用 任意 名 称 都 可 以 。 范 例 程 序 使 用 的 名 称 是 pickerimage.jpg。 由 于 我 们 只 是 想 演示 一 下 数据 友 送 
功能 ， 因 此 文件 名 并 不 需要 和 上 妈 送 的 内 容 有 所 关联 : 


[mcvc addAttachmentData:UIImageJPEGRepresentation(image, 1.0f) 
mimeType:G"image/jpeg" fileName:G"pickerimage.jpg"]; 


Qi 通过 iOS 的 MFMailComposeViewControllet 来 撰写 邮件 时 ， 附 件 会 出 现在 所 发 邮件 的 末尾 。 由 于 苹果 公司 和 Microsoft 在 邮件 的 表现 形式 上 有 区 别 ， 所 以 苹果 
公司 并 未 提供 把 图 像 直 接 浴 入 HTML 文 本 的 方式 。 


8.9 解决 方案 : 发 送 文 本 消息 


在 应 用 程序 里 友 短 信和 要 比 发 送 电 子 邮件 更 简单 。 图 8-4 演 示 了 相关 的 控制 器 。 与 友 送 邮件 时 的 做 法 一 样 ， 我 们 也 要 先 确保 iOS 设 备 具 有 友 送 文本 消息 的 能 力 ， 此 
外 ， 程 序 的 控制 器 还 要 遵循 MFMessageCompose-ViewControllerDelegate 协 议 : 


[MFMessageComposeViewController canSendText] 


设备 有 时 能 够 发 送 短信 ， 有 时 则 不 能 ， 我 们 可 以 监听 MFMessageComposeViewControllerText-MessageAvailabilityDidChangeNotification 通 知 来 获知 这 一 
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图 8-4 ”通过 MFMessageComposeView-Controllet 来 编写 文本 消息 


解决 方案 8-8 新 建 了 MFMessageComposeView-Controller， 并 设置 了 它 的 messageCompose-Delegate 及 body。 如 果 预 先知 道 收 信和 人， 那么 可 以 把 表示 电话 
号 码 的 一 些 字符 串 放 在 数组 里 ， 传 给 该 控制 器 。 按 照 自己 的 方式 把 控制 器 展示 出 来 之 后 ， 我 们 就 等 待 委 托 回调 ， 这 个 回调 方法 应 该 将 控制 器 关闭 。 


解决 方案 8-8 ”发送 文 本 消息 


- (void)messageComposeViewController: 
(MFMessageComposeViewController *)controller 
didFinishWithResult: (MessageComposeResult)result 


[self performDismiss]; 


switch (result) 
{ 
case MessageComposeResultCancelled: 
NSLog (@"Message was cancelled"); 
break; 
case MessageComposeResultFailed: 
NSLog(@"Message failed"); 
break; 
case MessageComposeResultSent : 
NSLog (@"Message was sent"); 
break; 
default: 
break; 


- (void) sendMessage 
MFMessageComposeViewController *mcvc = 
[[MFMessageComposeViewController alloc] init]; 
mcvc.messageComposeDelegate - self; 


if ([MFMessageComposeViewController canSendAttachments]) 
[ncvc addAttachmentData: 
UIImagePNGRepresentation([UIImage 
imageNamed:@"BookCover"] ) 
typeIdentifier:G"png" filename:@"BookCover.png"] ; 


mcvc.body = @"I'm reading the iOS Developer's Cookbook"; 
[self presentViewController:mcvc]; 


- (void) loadView 
{ 
self.view = [[UIView alloc] init]; 
self.view.backgroundColor = [UIColor whiteColor] ; 
if ([MFMessageComposeViewController canSendText] ) 
self .navigationItem.rightBarButtonItem = 
BARBUTTON (@"Send", @selector (sendMessage) ) ; 
else 
self.title = @"Cannot send texts"; 


iOS 7 的 MFMessageComposeViewController 已 经 有 上 友 送 附件 的 功能 了 。 在 添加 附件 之 前 ， 请 先 用 MFMessageComposeViewController 的 类 方法 
cansSendAttachments 来 判断 设备 是 否 能 友 送 附件 。 如 果 可 以 ， 那 么 解决 方案 8-8 就 会 给 消息 里 面 添加 一 张 图 片 。 


8.10 解决 方案 : 在 性 区 网 站 友 布 消 恩 


Social 框 架 提供 了 一 套 统一 的 APl， 能 够 把 应 用 程序 与 社交 网 站 结合 起 来 。 该 框架 目前 支持 Facebook、Twitter 以 及 中 国 的 新 浪 微 博 (Sina Weibo) 和 腾讯 微 博 
(Tencent Weibo) 。 与 发 送 邮 件 及 编写 消息 时 类 似 ， 在 使 用 某 服务 之 前 ， 先 要 判断 系统 是 否 支 持 该 服务 : 


[SLComposeViewController isAvailableForServiceType:SLServiceTypeFacebook] 


如 果 支 持 ， 那 么 就 可 以 创建 针对 该 服务 的 SLComposeViewController 了 。 


SLComposeViewController *fbController = [SLComposeViewController 
composeViewControllerForServiceType:SLServiceTypeFacebook]; 


我 们 用 图 像 、URL 以 及 一 段 文本 来 定制 这 个 控制 器 。 解 决 方案 8-9 按 步骤 演示 了 如 何 创建 如 图 8-? 中 所 示 的 界面 。 
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图 8-5 ”编写 Twittet 消 息 


QET iOS 6 在 引入 SLComposeViewController 之 后 ，iOS 5 的 TWTweetComposeView-Controller 就 废弃 了。 虽说 这 两 套 API 基 本 相同 ， 但 是 废弃 的 那个 版 本 里 面 有 一 


些 容易 出 错 的 地 方 需要 回避 。 所 以 我 们 应 该 使 用 SLComposeViewControllet 版 本 来 分 享 Twitter 消 息 。 


解决 方案 8-9 ”在 社交 网 站 发 布 消息 


- (void)postSocial: (NSString *)serviceType 
{ 
// Establish the controller 
SLComposeViewController *controller = [SLComposeViewController 
composeViewControllerForServiceType:serviceType]; 


// Add text and an image 
[controller addImage: [UIImage imageNamed:G"BookCover"]]; 
[controller setInitialText: 

@"I'm reading the iOS Developer's Cookbook"]; 


// Define the completion handler 
controller.completionHandler - 
^(SLComposeViewControllerResult result) { 
Switch (result) 
{ 
case SLComposeViewControllerResultCancelled: 
NSLog (@"Cancelled") ; 
break; 
case SLComposeViewControllerResultDone: 
NSLog (@"Posted") ; 
break; 
default: 
break; 


H 


// Present the controller 
[self presentViewController:controller]; 


- (void)postToFacebook 


| 


[self postSocial:SLServiceTypeFacebook]; 


- (void)postToTwitter 


| 


[self postSocial:SLServiceTypeTwitter]; 


- (void)loadView 


self.view - [[UIView alloc] init]; 
self.view.backgroundColor = [UIColor whiteColor]; 
if ([SLComposeViewController 


isAvailableForServiceType:SLServiceTypeFacebook]) 
self.navigationItem.leftBarButtonItem - 
BARBUTTON (@"Facebook", Gselector(postToFacebook)); 


if ([SLComposeViewController 
isAvailableForServiceType:SLServiceTypeTwitter]) 
self.navigationItem.rightBarButtonItem - 
BARBUTTON(G"Twitter", Gselector(postToTwitter)); 


数据 的 分 享 与 查看 


上 面 几 条 解决 方案 分 别 演示 了 如 何 发 送 电 子 邮件 、 如 何 友 送 文 本 消息 以 及 如 何在 社交 网 站 发布 消息 。iOS 提 供 了 一 些 控制 器 ， 可 以 简化 数据 的 分 享 与 查看 操作 ,， 它 
们 支持 很 多 种 数据 类 型 ， 也 支持 很 多 种 友 布 渠道 。UIActivityViewController 可 以 把 各 种 数据 分 享 操作 集中 起 来 ， 它 内 置 的 功能 包括 友 送 电子 邮件 、 在 社交 网 站 友 布 消 
息 、 打 印 等 ， 此 外 ， 开 发 者 还 能 够 扩展 这 个 控制 器 ， 用 以 支持 自 定义 的 操作 。QLPreviewController 使 得 应 用 程序 能 够 查看 许多 种 自己 不 大 能 够 处 理 的 数据 。 第 11 章 将 


会 详 述 这 两 个 类 。 


8.11 人 小结 


本 章 介绍 了 一 些 现成 的 控制 器 ， 开 发 者 可 以 用 它们 制备 出 各 种 优秀 的 功能 。 通 过 系统 所 提供 的 这 些 控制 器 ， 我 们 可 以 用 代码 轻松 地 实现 出 分 享 Twitter 消息 以 及 友 
送 电子 邮件 等 音 见 的 任务 。 大 家 现在 来 回顾 一 下 前 面 讲 过 的 几 个 问题 : 


` 尽管 我 们 自己 也 能 实现 出 这 些 控制 器 ， 但 是 没有 必要 这 么 做 。 系 统 所 提供 的 控制 器 可 以 在 开发 者 自己 设计 的 程序 与 其 他 程序 之 间 保 持 协调 一 致 的 用 户 体验 ， 我 
们 很 少 能 遇 到 这 样 好 用 的 类 了 。 无 论 采 用 哪个 程序 来 编写 邮件 ， 用 户 看 到 的 界面 都 是 相同 的 。 开 发 者 在 编写 发 送 电子 邮件 、 分 享 Twittet 消 息 以 及 访问 系统 媒体 库 等 功 
TA 


能 的 时 候 ， 应 该 通过 革 果 公司 的 系统 服务 来 实现 才 对 。 


: UIImagePicketConttollet 这 个 类 现在 变 得 有 些 策 抽 ， 其 实 它 早 就 应 该 重新 设计 了 。 我 们 可 以 调整 媒体 来 源 ， 以 减少 它 的 内 存 用 量 ， 但 同时 也 希望 苹果 公司 能 把 这 
个 类 改善 一 下 。 有 很 多 功能 强大 的 媒体 处 理 类 已 经 移植 到 iOS 了 ， 所 以 UIImagePickerControllet 类 不 应 该 只 是 个 可 以 显示 出 来 的 控制 器 ， 它 还 应 该 与 AV Foundation. Core 


Media 以 及 其 他 一 些 关 键 技术 集成 起 来 才 好 。 苯 重用 户 隐私 固然 非常 重要 ， 但 如 果 系 统 能 够 多 开放 一 些 API 的 话 ， 就 更 好 了 (这 些 API 当 然 要 在 获得 用 户 的 许可 之 后 方 能 


- 除了 能 在 Facebook 和 Twitteft 上 面 发 表 消 息 ，Social 框 架 还 能 执行 很 多 事情 。 通 过 SLComposeViewConttollerf 类 ， 我 们 可 以 用 适当 的 安全 机 制 来 提交 已 认证 
(authenticated) 和 未 认证 (unauthenticated) 的 各 种 服务 请 求 。 把 Accounts 框 架 同 Social 框 架 结合 起 来 ， 就 能 获取 受过 验证 的 登录 信息 ， 并 以 该 账户 的 身份 发 送 相 关 请 


、 
二 | 人 
Ro 


第 9 草 创建 并 管理 表格 视图 


表格 是 一 种 基于 滚动 列表 的 互动 类 ， 它 尤其 适合 展示 小 型 GUI 元 件 。iPhone 与 iPod touch 自 带 许多 程序 ， 其 导航 方式 都 以 表格 为 中 心 ， 包 括 Contacts、Settings 
及 iPod 播放 界面 等 。 由 于 这 些小 型 IOS 设 备 的 屏幕 空间 有 限 ， 因 此 用 可 以 滚动 的 表格 来 展示 每 个 备 选 条 目 是 一 种 比较 理想 的 信息 传递 方式 ， 它 能 把 内 容 以 简洁 、 易 操作 
的 形式 展现 出 来 。iPad 的 屏幕 则 比较 大 ， 这 使 得 表格 能 够 与 更 大 的 细节 展示 视图 集成 起 来 ， 从 而 成 为 分 栏 视图 控制 器 (split view controller) 中 的 重要 组 件 。 本 章 要 
讲解 IOs 表 格 的 运作 方式 、 可 供 开发 者 使 用 的 表格 类 型 以 及 怎样 在 自己 的 程序 中 使 用 表格 的 各 项 特性 。 


9.1 iOS 的 表格 


标准 的 iOs 表 格 是 一 张 包 含 单 元 格 的 垂直 滚动 列表 。 用 户 可 以 向 上 、 向 下 深 动 或 滑动 这 张 表格 ， 直 到 友 现 目 己 想 要 操作 的 内 容 。iOs 里 面 到 处 都 能 看 见 表 格 。 许 多 
内 置 的 IOs 程 序 完全 以 表格 为 基础 来 构建 ， 而 且 大 量 的 第 三 方程 序 也 把 表格 作为 核心 展示 形式 。 


iOs 中 的 大 部 分 表格 都 是 用 UITableView 构 建 的， 而 且 通 过 委托 及 数据 源 协议 所 提供 的 各 种 选项 做 了 定制 。 通 用 的 表格 实现 形式 是 把 单元 格 放 企 垂 直 滚 动 的 列表 
里 ， 不 过 我 们 也 可 以 创建 市 有 目 定义 图 案 、 育 景色 、 标 答 等 元 素 的 专用 表格 。 


这 些 特 别 的 表格 包括 Preferences 程 序 里 面 那 种 把 白色 单元 格 放 在 灰色 背景 上 的 表格 ， 以 及 Contacts 程 序 里 面 那 种 分 成 不 同 区 域 (section) 并 且 市 有 索引 
(index) 的 表格 ， 此 外 还 有 一 些 与 滚动 式 表 格 有 关 的 类 ， 例 如 设置 约会 时 间 及 闹钟 所 用 的 那 种 表格 。 如 果 想 展示 网 格 状 的 界面 ， 而 不 仅 仪 是 表格 和 深 动 列表 ， 那 么 可 
以 使 用 与 集合 视图 有 关 的 一 些 类 ， 第 10 章 将 会 讲述 这 些 类 。 


无 论 使 用 哪 种 表格 ， 其 运作 方式 通常 都 是 相同 的 。 表 格 是 遵照 Model-View-Controller (模型 -视图 -控制 器 ，MVC) 范式 构建 的 。 它 们 会 把 数据 源 以 单元 格 的 形 
了 式 展 示 出 来 ， 并 且 通 过 定义 明确 的 委托 方法 来 响应 用 户 的 操作 。 


数据 源 是 一 个 类 ， 它 可 以 根据 需求 来 提供 与 表格 内 容 有 关 的 信息 。 它 代表 底层 数据 模型 ， 而 且 可 以 协调 模型 与 表格 视图 之 间 的 关系。 数据 源 会 将 其 结构 告知 表 
格 。 比 万 说 ， 它 会 告诉 表格 应 该 使 用 多 少 个 区 域 以 及 每 个 区 域 包 含 多 少 个 条 目 。 数 据 源 可 以 按照 需要 分 别提 供 表格 里 的 每 个 单元 格 ， 并 根据 单元 格 在 表 中 的 位 置 ， 以 
数据 模型 来 填充 这 些 单元 格 。 


数据 源 相当 于 表格 的 模型 ， 而 委托 则 相当 于 控制 器 。 委 托 用 来 管理 用 户 的 操作 ， 当 用 户 想 要 选择 表格 内 容 或 想 要 编辑 表格 时 ， 应 用 程序 可 以 通过 委托 来 响应 这 些 
变化 。 例 如 ， 用 户 可 能 想 要 点 选 新 的 单元 格 ， 或 是 想 将 某 单元 格 放 在 另 一 个 位 置 ， 也 有 可 能 是 想 添 加 或 移 除 单 元 格 等 。 委 托 可 以 监控 用 户 的 这 些 操作 请 求 ， 人 允许 或 茜 
止 它们 ， 在 操作 成 功 之 后 ， 还 能 更 新 数据 模型 以 反映 这 一 变化 。 


视图 、 数 据 源 与 委托 三 者 搭配 起 来 ， 体 现 了 一 种 MVC 开 发 模式 。 这 种 模式 并 不 局 限于 表格 视图 。 很 多 关键 的 OS 类 里 都 能 看 到 这 样 的 “视图 /数据 源 /委托 ”组 合 。 


选取 器 视图 、 集 合 视图 以 及 页 面 视图 控制 器 都 用 到 了 数据 源 与 委托 。 


表格 视图 的 数据 源 与 委托 是 一 种 委托 ， 也 就 是 把 特定 的 操作 和 信息 交 给 另 一 个 辅助 对 象 来 处 理 。UIKit 中 的 很 多 类 都 通过 委托 机 制 来 啊 应 用 户 操作 并 提供 相关 内 
容 。 比 方 说， 设置 了 表格 的 委托 之 后 ， 系 统 融会 把 与 交互 操作 有 关 的 消息 传 给 它 ， 并 且 令 这 个 委托 来 处 理 这 些 消息 。 


表格 视图 很 好 地 说 明了 委托 的 优点 。 用 户 点 击 表格 的 某 一 行 时 ，UITableView 实 例 并 没有 提供 内 置 的 方式 来 响应 这 次 触摸 。 它 是 个 通用 的 类 ， 所 以 本 身 并 没有 提 
供与 点 击 操作 相关 的 语义 。 用 户 点 选 某 个 单元 格 时 ， 表 格 会 询问 其 委托 (这 个 委托 通常 是 个 视图 控制 器 类) ， 并 把 与 这 次 操作 有 关 的 变更 信息 传 过 去 。 开 友 者 可 以 在 
委托 里 面 添加 与 处 理 点 击 操作 所 用 的 代码 ， 这 样 忒 把 添加 此 种 代码 的 时 间 点 与 苹果 公司 创建 表格 类 的 时 间 扣 完全 分 阳 开 。 通 过 委托 机 制 ， 我 们 可 以 创建 一 种 没有 有 具体 
含义 的 类 ， 而 把 与 程序 有 关 的 具体 处 理 代码 留 给 开 友 者 稍 后 去 编写 。 


UITableView 里 有 个 委托 方法 叫 作 tableView: didSelectRowAtIndexPath: [11， 它 很 好 地 演示 了 委托 这 一 概念 。 委 托 对 象 需 要 定义 这 个 方法 ， 并 指明 应 用 程序 应 
该 如 何 响应 由 用 户 所 发 起 的 选 定 操作 。 开 发 者 可 以 显示 一 份 菜单 ， 或 是 跳 转 到 子 视图 ， 也 可 以 在 用 户 点 击 的 这 一 行 里 添上 选取 符号 。 具 体 的 响应 方式 完全 取决 于 开发 
者 如 何 来 实现 这 个 处 理 选取 操作 的 委托 方法 。 在 实现 表格 类 本 身 的 时 候 ， 系 统 完全 不 知道 这 些 内 容 。 


通过 delegate 及 datasource 属 性 ， 我 们 可 以 设置 表格 视图 的 委托 及 数据 源 。 应 用 程序 会 把 与 交互 操作 有 关 的 回调 传 给 开发 者 所 赋 的 相关 对 象 。 为 了 使 Objective- 
知道 这 些 对 象 实现 了 委托 方法 ， 我 们 必须 在 对 象 所 属 的 类 上 面 声明 这 些 类 遵从 了 相关 的 协议 才 行 。 在 声明 了 某 个 类 继承 自 何 类 之 后 ， 可 以 在 右边 放 上 一 对 尖 括 号 ， 并 
把 本 类 所 遵循 的 协议 置 于 其 中 (例如 <UlTableViewDelegate> 或 <UlTableViewDataSource>) 。 如 果 要 宣称 该 类 遵循 多 项 协议 ， 那 么 束 用 逗号 将 各 协议 隔 开 ， 并 把 
它们 一 起 放 在 尖 括 号 内 (例如 <UlTableViewDelegate，UlTableViewDataSource>) 。 遵 循 某 项 协议 之 后 ， 该 类 束 必 须 实现 协议 中 规定 的 必 备 方法 ， 同 时 也 可 以 实 
现 一 些 可 选 方法 。 


[1] 这 是 一 种 习惯 称谓 ， 严 格 来 说 ， 应 该 是 UITableViewDelegate 协 议 中 的 tableView:didSelect-RowAtIndexPath: 方 法 ， 下 同 。 译 者 注 


9.3 ”创建 表格 


iOs 里 面 主 要 有 两 个 与 表格 有 天 的 类 ， 一 个 是 预先 构建 好 的 控制 器 类 (UlTable-ViewController) ， 另 一 个 是 可 以 直接 显示 出 来 的 视图 类 (UITableView) 。 控 制 
器 是 个 专门 为 表格 而 定制 的 UIViewController 子 类 ， 它 所 建立 的 表格 视图 会 完全 占据 整个 控制 器 的 视图 空间 ， 而 且 它 还 给 开发 者 省 去 了 很 多 使 用 表格 实例 时 所 要 重复 
执行 的 编码 工作 。 尤 为 重要 的 是 ， 它 已 经 把 使 用 表格 时 所 需 遵从 的 协议 全 部 声明 好 了 ， 并 将 自身 设 为 表格 的 delegate 与 数据 源 。 如 果 要 在 该 控制 器 类 之 外 使 用 表格 视 
， 那 么 开发 者 必须 手工 编写 这 些 代 码 ， 而 UITableViewController 则 会 自动 处 理 好 这 些 事 。 


9.3.1 ”表格 的 样式 
iPhone 上 面 的 表格 有 两 种 形式 : 普通 表格 与 分 组 表格 。 在 默认 情况 下 ， 普 通 表 格 的 背景 是 白色 的 ， 上 面 会 有 透明 的 单元 格 。iOS 的 Settings 程 序 使 用 分 组 形式 的 表 
iS, KP RGN RE KB, RPS KIS Ree. 


右 想 改变 表格 样式 ， 只 需 在 初始 化 UITableViewController 的 时 候 指 定 另外 一 种 样式 即 可 。 在 新 建 实 例 的 时 候 ， 可 以 明确 指定 表格 样式 。 一 旦 初始 化 完毕 ， 融 不 能 
再 更 改 了 。 下 面 给 出 范例 代码 : 


myTableViewController = [[UITableViewController alloc] 
initWithStyle:UITableViewStyleGrouped]; 


如 果 使 用 的 控制 器 是 从 XIB 或 故事 板 中 加 载 的 ， 那 么 可 以 在 Xcode 的 Attributes Inspector 里 调整 Table View» Style 属 性 。 


9.3.2 HRM 


正如 其 名 称 所 示 ，UITableView 实 例 是 一 种 在 iOs 屏 幕 中 展示 互动 式 表格 的 视图 。 因 为 UITableView 类 继承 自 UlscrollView 类 ， 所 以 表格 具备 上 下 滚动 的 功能 。 与 
其 他 视图 一 样 ，UITableView 实 例 也 通过 frame (框架 ) 来 定义 自身 的 边界 ， 而 且 可 以 成 为 其 他 视图 的 子 视图 或 上 级 视图 。 要 创建 表格 视图 ， 开 发 者 需要 分 配 内 存 ， 并 
且 用 frame 或 Auto Layout 约 束 规则 来 初始 化 它 ， 然 后 通过 设置 数据 源 与 委托 对 象 来 添加 所 有 的 细节 处 理 代 码 。 


UITableViewController 会 自己 把 视图 排 布 好 。 该 类 创建 标准 的 视图 控制 器 ， 在 其 中 放置 UITableView， 并 设置 其 frame， 以 便 给 导航 栏 或 工具 栏 等 留 出 空间 。 我 
们 可 通过 tableView 实 例 变 量 来 访问 UITableView (表格 视图 ) 。 


9.3.3 ”设置 效 据 源 
UITableView 实 例 依赖 于 一 种 外 部 来 源 ， 该 来 源 可 以 根据 程序 需要 来 提供 新 的 单元 格 ， 或 向 现 有 的 单元 格 内 填充 新 数据 。 单 元 格 (Cell) 是 一 种 构成 表格 的 小 视 
至 ， 用 以 表示 表格 里 每 一 行 的 内 容 。 这 种 外 部 的 数据 来 源 束 叫 作 数据 产 ， 它 是 指 负 责 根据 程序 的 需求 来 向 表格 提供 单元 格 的 对 象 。 


设 为 表格 dataSource 属 性 的 那个 对 象 负责 向 表格 提供 单元 格 以 及 其 他 布局 信息 。 该 对 象 必须 宣称 自己 遵循 UlTableViewDataSource 协 议 ， 并 实现 协议 中 的 相关 方 
法 。 除 了 能 返回 单元 格 之 外 ， 表 格 的 数据 源 还 指定 了 表格 中 的 分 区 数 、 每 个 分 区 的 单元 格 数 、 分 区 的 标题 、 单 元 格 的 高 度 等 内 容 ， 此 外 ， 它 也 可 以 提供 一 份 可 选 的 目 
录 。 数 据 源 定义 了 表格 的 样 够 以 及 填充 在 表格 中 的 内 容 。 


一 般 来 说 ， 拥 有 表格 视图 的 那个 视图 控制 器 就 是 表格 视图 的 数据 源 。 如 果 使 用 UITableViewController 的 子 类 来 开发 ， 那 么 就 不 需要 再 声明 它 遵循 UlTable- 
ViewDataSource 协 议 了 ， 因 为 父 类 本 身 束 支持 该 协议 ， 而 且 还 会 把 控制 器 目 动 设 为 数据 源 。 


9.3.4 提供 单元 格 

表格 的 数据 源 需 要 实现 tableView: cellForRowAtIndexPath: 方法 ， 以 便 向 表格 提供 单元 格 。 只 要 调用 了 表格 的 reloadData 方 法 ， 表 格 就 会 向 数据 源 索要 数 
据 ， 以 便 把 屏幕 上 将 要 显示 出 来 的 单元 格 填充 好 。 开 发 者 可 以 随时 用 代码 来 调用 reloadData 方 法 ， 这 样 做 会 迫使 表格 重新 加 载 其 内 容 。 

系统 在 调用 tableView: cellForRowAtindexPath: 方法 的 时 候 ， 数 据 源 应 该 根据 indexPath 参 数 中 的 索引 路 径 来 向 表格 提供 单元 格 。 索 引路 径 是 NSlndexPath 类 
的 对 象 ， 它 描述 了 从 数据 树 到 某 个 节点 所 经 的 路 径 ， 这 条 路 径 实际 上 就 是 单元 格 所 在 的 分 区 及 行 。 用 分 区 和 行 可 以 创建 出 NSIndexPath: 


NSIndexPath *myIndexPath = [NSIndexPath indexPathForRow:5 inSection:0]; 


我 们 可 以 用 section 把 表格 里 的 数据 按照 逻辑 分 成 组 ， 然 后 在 每 个 section 中 ， 用 row 来 表示 单元 格 的 位 置 。 数 据 源 负责 把 NslndexPath 和 具体 的 UITableViewCell 
实例 对 应 起 来 ， 并 根据 需求 向 表格 提供 单元 格 。 


9.3.5 ”注册 单元 格 类 


创建 表格 视图 的 时 候 ， 应 该 及 早 注 册 表 格 所 用 的 单元 格 类 型 。 注 册 了 之 后 ，UITableView 的 dequeueReusableCellWithldentifier 方 法 就 能 自动 创建 新 的 单元 格 
了 。 一 般 来 说 ， 我 们 会 在 初始 化 方法 、loadView 方 法 或 viewDidLoad 方 法 里 面 注册 单元 格 。 这 个 注册 步骤 必须 在 表格 初次 加 载 其 数据 之 前 完成 。 每 个 UlTableView 实 
例 都 需要 注册 它 自己 用 到 的 单元 格 类 型 。 注 册 的 时 候 ， 开 友 者 可 将 一 个 字符 串 用 作 标 识 符 ， 稍 后 在 索要 新 的 单元 格 时 ， 可 以 把 这 个 字符 串 当 成 键 。 


我 们 可 以 按照 类 或 XIB 来 注册 单元 格 ， 前 一 种 方式 适用 于 iOS 6 及 后 续 系 统 ， 后 一 种 方式 适用 于 iOS 5 及 后 续 系 统 。 下 面 这 段 范例 代码 演示 了 这 两 种 注册 方式 : 


[self.tableView registerClass: [UITableViewCell class] 
forCellReuseIdentifier:@'"table cell"]; 
[self.tableView registerNib: 
[UINib nibWithNibName:@"CustomCell" bundle: [NSBundle mainBundle]] 
forCellReuseIdentifier:G"custom cell"]; 


开 友 者 可 以 注册 很 多 种 单元 格 ， 并 不 是 说 一 张 表格 只 能 使 用 一 种 单元 格 。 我 们 可 以 根据 程序 的 需求 ， 在 同一 张 表 格 中 混合 使 用 多 种 类 型 的 单元 格 。 


9.3.6 从 队列 中 取出 单元 格 


当 程 序 向 数据 源 索 要 单元 格 的 时 候 ， 它 可 以 通过 代码 来 构建 UITableViewCell， 也 可 以 从 Interface Builder (IB) 的 资源 中 加 载 UITableViewCell。 下 面 是 个 极为 
简单 的 数据 源 方法 ， 它 会 根据 所 请 求 的 NslndexPath 返 回 单元 格 ， 并 把 数据 模型 中 的 相关 文本 用 作 这 个 单元 格 的 标签 : 


- (UITableViewCell *)tableView: (UITableView *)aTableView 
cellForRowAtIndexPath: (NSIndexPath *)indexPath 


UITableViewCell *cell - [self.tableView 
dequeueReusableCellWithIdentifier:G"cell" 
forIndexPath:indexPath]; 

cell.textLabel.text - 

[dataModel objectAtIndexPath:indexPath].text; 
return cell; 


} 


如 果 你 是 位 iOS 开 发 老手 ， 那 么 应 该 会 党 得 这 个 方法 挺 好 的 ， 因 为 我 们 不 需要 再 去 判断 队列 中 有 没有 所 需 类 型 的 单元 格 了 。 无 论 有 没有 我 们 需要 的 单元 格 ， 队 列 都 
会 在 必要 的 时 候 创 建 并 初始 化 新 的 UITableViewCell 实 例 。 


我 们 通过 队列 机 制 来 索要 单元 格 。 单 元 格 在 离开 表格 的 可 视 范围 之 后 ， 就 会 缓存 到 队列 里 ， 以 便 稍 后 重新 使 用 。 队 列 机 制 会 把 保存 在 队列 中 的 可 用 单元 格 返 回 给 
调用 者 ， 如 果 队 列 中 没有 这 种 单元 格 ， 那 它 融会 自行 创建 并 返回 新 的 单元 格 实例 。 


把 可 以 复 用 的 单元 格 类 型 注册 好 之 后 ， 每 个 单元 格 实例 就 会 有 一 个 标识 符 标签 (identifier tag) 。 在 需要 用 到 单元 格 的 时 候 ， 表 格 会 按照 类 型 在 队列 中 搜寻 ,并 
把 可 以 复 用 的 单元 格 取 出 来 。 这 样 做 可 以 节省 内 存 ， 此 外 ， 如 果 用 尸 快速 地 滚动 一 份 很 长 的 列表 ， 那 么 这 种 做 法 还 能 够 迅速 而 高 效 地 提供 表格 所 需 的 单元 格 。 


9.3.7 i&gidelegate 
与 Cocoa Touch 中 的 很 多 交互 式 对 象 一 样 ，UITableView 实 例 也 通过 delegate 来 响应 用 户 的 操作 并 做 出 适当 的 应 答 。 表 格 的 delegate 可 以 响应 诸如 表格 滚动 、 用 
户 编 辑 或 选中 某 行 等 事件 。 通 过 委托 机 制 ， 表 格 把 响应 这 些 操作 的 责任 交 给 开 友 者 所 指定 的 委托 对 象 ， 而 这 个 委托 对 象 通常 就 是 拥有 表格 视图 的 那个 控制 器 对 象 。 


如 果 想 直接 使 用 UITableView， 那 么 束 把 它 的 delegate 属 性 设置 成 可 以 响应 相关 事件 的 某 个 对 象 。 这 个 delegate 对 象 所 属 的 类 必须 宣称 自己 实现 了 
UlTableViewDelegate 协 议 。 与 dataSource 属 性 一 样 ， 如 果 我 们 直接 使 用 UITableViewController 类 或 是 从 中 继承 子 类 ， 那 么 就 无 须 设置 delegate， 也 不 用 再 宣称 该 
类 遵循 UlTableViewDelegate 协 议 了 。 


9.4 解决 方案 : 实现 简单 的 表格 


要 想 实 现 一 张 人 简单 的 表格 ,我 们 只 需 提供 一 些 数 据 ， 用 以 设置 单元 格 的 标签 (label) ， 然 后 再 实现 几 个 万 法 束 行 了 。 解 决 方案 9-1 残 提供 了 这 样 一 种 极其 简单 的 表 
格 。 这 张 表格 是 不 分 区 的 ， 其 效果 如 图 9-1 所 示 。 每 个 单元 格 都 有 文本 标签 及 图 像 ， 这 种 图 像 是 中 间 写 有 行 号 的 方 格 。 
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图 9-1 由 解决 方案 9-1 所 构建 的 简单 表格 视图 
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mhindi, sop Site RARE, WRITE, APART etS HAA Rum (UlTableViewScrollPositionTop) 。 表 格 中 的 最 
后 一 项 (也 融 是 Zulu) 是 不 能 向 上 深 动 的 ， 它 只 能 留 在 视图 底部 ， 因 为 后 面 没 有 其 他 单元 格 了 。 


9.4.1 ZORRIA 


即便 想 显示 解决 方案 9-1 这 样 简 单 的 表格 ， 其 数据 源 也 必须 实现 三 个 核心 的 实例 方法 才 行 。 这 些 方法 定义 了 表格 的 组 织 方 式 ， 并 且 负 责 向 表格 提供 内 容 : 


. numberOfSectionsiInTableView 一 一 表格 可 以 把 数据 显示 到 不 同 的 区 域 中 ， 也 可 以 把 所 有 数据 都 放 在 一 份 清单 里 。 如 果 想 创建 普通 的 表格 ， 那 么 就 令 该 方法 返 
回 1。 这 表示 整 张 表 都 会 显示 为 一 份 清单 。 若 想 创建 分 区 显示 的 表格 ， 则 返回 2 或 2 以 上 的 值 。 


- tableView: numberOfRowslnSection: 该 方法 返回 某 个 分 区 内 的 行 数 。 对 于 解决 方案 9-1 这 种 普通 的 表格 来 说 ， 这 个 方法 返回 的 就 是 整 张 表格 的 行 数 。 如 
果 表 格 更 为 复杂 一 些 ， 那 么 就 要 设法 查 出 每 个 分 区 所 拥有 的 行 数 了 。 我 们 在 12 章 将 会 看 到 ，Cote Data 非 常 适 合 与 这 种 分 成 不 同 区 域 的 表格 相 集 成 。 与 OS 中 的 所 有 计数 


机 制 一 样 ， 分 区 的 序号 也 从 0 开始 ， 首 个 分 区 的 序号 是 0。 


- tableView: cellForRowAtlndexPath : 


该 方法 应 该 返回 调用 表格 所 需 的 单元 格 。 开 发 者 需要 根据 索引 路 径 (NSIndexPath) 中 的 row 和 section 属 性 来 决定 返 
回 什么 桩 的 单元 格 ， 同 时 也 应 该 利用 可 复 用 的 单元 格 来 尽量 降低 内 存 用 量 。 


解决 方案 9-1 构建 简单 的 表格 


@implementation TestBedViewController 
UIFont *imageFont; 
NSArray *items; 


// Number of sections 
- (NSInteger)numberOfSectionsInTableView: (UITableView *)aTableView 


| 


return 1; 


// Rows per section 
- (NSInteger)tableView: (UITableView *) aTableView 
numberOfRowsInSection: (NSInteger)section 


return items.count; 


// Return a cell for the index path 
- (UITableViewCell *)tableView: (UITableView *)aTableView 
cellForRowAtIndexPath: (NSIndexPath *)indexPath 


UITableViewCell *cell = [self.tableView 
dequeueReusableCellWithIdentifier:G"cell" 
forIndexPath:indexPath]; 


// Cell label 
cell.textLabel.text = items [indexPath. row] ; 


// Cell image 
NSString *indexString = 

[NSString stringWithFormat:@"%02d", indexPath.row] ; 
cell.imageView.image = 

stringImage(indexString, imageFont, 6.0f); 


return cell; 
// On selection, update the title and enable find/deselect 
- (void)tableView: (UITableView *)aTableView 


didSelectRowAtIndexPath: (NSIndexPath *)indexPath 


UITableViewCell *cell - 


[self.tableView cellForRowAtIndexPath:indexPath]; 
self.title - cell.textLabel.text; 
self.navigationItem.rightBarButtonItem.enabled = YES; 
self.navigationItem.leftBarButtonItem.enabled - YES; 


// Deselect any current selection 
- (void)deselect 


{ 


NSArray *paths = [self.tableView indexPathsForSelectedRows] ; 
if (!paths.count) return; 


NSIndexPath *path = paths[0]; 

[self.tableView deselectRowAtIndexPath:path animated:YES]; 
self .navigationItem.rightBarButtonItem.enabled = NO; 
self.navigationItem.leftBarButtonItem.enabled = NO; 


self.title = nil; 


// Move to the selection 
- (void) find 


{ 


[self.tableView scrollToNearestSelectedRowAtScrollPosition: 
UITableViewScrollPositionTop animated:YES]; 


// Set up table 
- (void)viewDidLoad 


| 


[super viewDidLoad] ; 
self.view.backgroundColor = [UIColor whiteColor] ; 


self .navigationItem.rightBarButtonItem = 

BARBUTTON (@"Deselect", @selector (deselect) ) ; 
self .navigationItem.leftBarButtonItem = 

BARBUTTON (@"Find", @selector(find) ); 
self .navigationItem.rightBarButtonItem.enabled = NO; 
self .navigationItem.leftBarButtonItem.enabled = NO; 


imageFont = [UIFont fontWithName:@"Futura" size:18.0f]; 

[self .tableView registerClass: [UITableViewCell class] 
forCellReuselIdentifier:@"cell"] ; 

items = [@"Alpha Bravo Charlie Delta Echo Foxtrot Golf \ 
Hotel India Juliet Kilo Lima Mike November Oscar Papa \ 


Quebec Romeo Sierra Tango Uniform Victor Whiskey Xray "^ 
Yankee Zulu" componentsSeparatedByString:@" "J; 


@end 


获取 解决 方案 代码 


访问 https://github.com/erica/iOS-7-Cookbook 网 页 ， 并 打开 “C09Tables” 文 件 夹 ， 即 可 找到 与 本 章 中 的 解决 方案 相对 应 的 完整 范例 项 目 。 


9.4.2” 啊 应 用 户 的 触 损 


解决 方案 9-1 在 名 为 tableView: didSelectRowAtIndexPath: 的 委托 方法 中 响应 用 户 的 操作 。 如 果 用 户 点 击 某 单元 格 ， 那 么 这 条 解决 方案 就 会 更 新 视图 控制 器 的 
标题 ， 并 启用 Find 及 Deselect 按 钮 。 只 要 用 户 所 选 内 容 有 效 ， 这 两 个 按钮 就 会 一 直 处 于 启用 状态 。 用 户 点 击 Deselect 按 钮 后 ， 范 例 代 码 会 调用 
deselectRowAtlndexPath: animated: 方法 ， 并 禁用 这 两 个 按钮 。 


Qez 如 果 想 令 表格 的 某 个 单元 格 忽略 用 户 的 触摸 操作 ， 那 么 可 以 将 selectionStyle 属 性 设 为 UITableViewCellSelectionStyleNone。 用 户 选 中 某 个 单元 格 之 后 ， 这 个 
单元 格 本 来 应 该 变 为 灰色 ,但 设置 了 该 属性 之 后 ， 它 就 不 会 变 灰 了 。 此 时 这 个 单元 格 仍然 处 在 选中 状态 ,但 它 并 不 会 以 视觉 效果 来 强调 这 一 状态 。 若 是 点 选单 元 格 这 


一 操作 除了 展示 信息 之 外 还 会 产生 其 他 效果 ， 那 么 这 个 办 法 恐怕 就 不 是 最 佳 方案 了 。 


9.5 UlTableViewCellZs 


UITableViewCell 类 提供 了 四 种 实用 的 基本 样式 ， 如 图 9-2 所 示 。 该 类 有 两 个 文本 标签 属性 ， 一 个 是 textLabel， 表 示 单 元 格 的 主 标题 ， 另 一 个 是 detailTextLabel， 
用 来 创建 子 标题 。 这 四 种 基本 的 样式 分 别 是 : 


- UlTableViewCellStyleDefault 一 一 这 种 单元 格 具备 一 个 左 对 齐 的 文本 标签 ， 而 且 可 以 指定 一 幅 图 像 。 如 果 使 用 了 图 像 ， 那 么 可 以 显示 文本 的 空间 就 变 小 了 ， 标 
签 就 会 出 现在 图 像 右 侧 。 开 发 者 可 以 访问 并 修改 detailTextLabel， 但 它 并 不 会 出 现在 屏幕 上 。 


签 以 较 大 的 黑 字 显示 在 单元 格 左 侧 ， 而 把 子 标题 以 较 小 的 灰 示 在 单元 格 右 侧 。 


当前 的 tintColor 为 文本 颜色 ， 把 主 标签 用 小 字 显 示 在 左 侧 ， 而 子 标题 则 会 以 黑色 小 字 出 现在 其 右 方 。 由 于 能 够 显 
示 主 标签 的 那 块 地 方 很 窗 ， 所 以 在 大 部 分 情况 下 ， 文 本 都 没 办 法 完整 显示 出 来 ， 单 元 格 会 用 省 略 号 表示 没 显示 出 来 的 那些 内 容 。 这 种 单元 格 不 支持 图 像 。 


示 签 显示 在 稍微 靠 上 一 些 的 位 置 ， 从 而 给 下 方 留 出 空间 ， 用 以 显示 细节 标签 。 这 两 个 标签 文本 都 


是 黑色 的 。 与 默认 风格 的 单元 格 一 样 ， 这 种 单元 格 也 可 以 设置 图 像 。 
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图 9-2 ”CocoaTouch 提 供 了 四 种 标准 的 单元 格 类 型 ， 其 中 有 好 几 种 都 可 以 设置 图 像 


9.5.1 单元 格 的 selectionStyle 属 性 
通过 selectionStyle 属 性 可 以 设置 用 户 所 选单 元 格 的 样 狐 。 在 iOS 7 中 ， 无 论 是 把 该 属性 设置 成 UITableViewCellSelectionStyleBlue， 还 是 把 它 设置 成 


UITableView-CellselectionSstyleGray， 用 户 所 选 的 单元 格 都 会 呈现 浅 灰色 背景 (虽说 前 者 的 字面 意思 是 蓝 色 ， 但 实际 上 还 是 浅 灰 色 ) 。 假 如 不 想 展 示 单元 格 受 选 时 的 
视 守 效果， 那么 束 把 该 属性 设 为 UlTableViewCellSelectionStyleNone。 用 尸 依然 可 以 选择 这 种 单元 格 ， 只 是 其 背景 不 会 呈现 灰色 。 


9.5.2 ”添加 目 定 义 的 单元 格 受 先 效 果 


当 用 户 选 中 某 个 单元 格 时 ， 可 以 通过 Cocoa Touch 所 提供 的 功能 来 强化 该 单元 格 受 选 时 的 效果 。 开 上 友 者 可 以 修改 相 天 属性 ， 以 此 来 定制 单元 格 受 选 时 的 行为 ， 从 
而 把 它 与 别 的 单元 格 区 分 开 。 与 之 相关 的 属性 有 了 两 个 。 


selectedBackgroundView 属 性 可 以 给 用 尸 所 选 的 单元 格 上 面 添加 控件 或 其 他 视图 。 这 类 似 于 出 现在 键盘 上 面 的 辅助 视图 。 我 们 可 以 在 用 户 所 选单 元 格 的 背景 视 
图 上 面 添加 预 移 按钮 或 购买 选项 。 


此 外 ， 还 可 以 修改 单元 格 标签 的 highlightedTextColor 属 性 ， 使 得 用 户 在 选中 单元 格 之 后 ， 其 中 的 标签 文本 能 够 以 另 一 种 颜色 显示 出 来 。 


9.6 ”解决 方案 : 创建 市 有 选取 标记 的 单元 格 


开发 者 能 够 通过 辅助 视图 来 扩充 普通 UITableViewCell 的 功能 。 我 们 可 以 用 选取 标记 (check mark) 来 创建 图 9-3 这 样 的 交互 式 单 选 (one-of-n selection) 表 或 
多 选 (n-of-n selection) 表 。 用 户 可 以 用 这 样 的 表格 来 点 餐 或 是 选取 想 要 更 新 的 条 目 。 
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图 9-3 ”通过 辅助 视图 来 添加 选取 标记 ， 我 们 就 能 非常 方便 地 实现 出 单 选 表 或 多 选 表 了 


为 了 给 受 选 条 目 添 加 选取 标记 ， 需 要 把 单元 格 的 accessoryType 属 性 设 为 UITable-ViewCellAccessoryCheckmark。 知 要 取消 选取 标记 ， 则 应 将 其 设 为 


UlTableView-CellAccessoryNone。 开 发 者 可 通过 accessoryType 属 性 来 指定 辅助 视图 中 的 图 案 。 


单元 格 没有 “i 记忆” 功能， 它们 只 知道 自己 上 一 次 显示 出 来 的 时 候 是 什么 样子 ， 但 却 并 不 知道 程序 上 一 


次 究竟 是 怎样 使 用 自己 的 。 单 元 格 只 不 过 是 个 视图 。 所 以 
说 ， 如 果 要 复 用 单元 格 的 话 ， 那 么 就 应 将 其 与 某 种 数据 模型 相 绑 定 ， 否 则 会 无 意 间 产生 不 符合 预期 的 结果 ， 这 是 


因为 使 用 了 MVC 设 计 范 式 而 导致 的 。 


比方 说 有 下 面 这 种 情况 。 我 们 创建 了 一 系列 单元 格 ， 每 个 单元 格 都 市 有 切换 式 的 开关 (toggle switch) 。 用 户 可 以 操作 开关 来 修改 其 值 。 如 果菜 单元 格 离开 了 屏 
莫 ， 那 么 就 会 出 现在 复 用 队列 中 。 假 如 这 个 单元 格 在 离开 屏幕 之 前 其 开关 处 于 打开 状态 ， 那 么 当 表格 稍 后 把 该 单元 格 复 用 到 其 他 元 素 上 面 的 时 候 ， 用 户 束 会 友 现 自己 
还 没有 点 击 那 个 元 素 ， 它 的 开关 却 已 经 打开 了 。 


为 了 修复 这 个 问题 ， 我 们 应 该 把 单元 格 的 状态 与 保存 起 来 的 模型 相 比 对 ， 并 在 cellForRowAtindexPath: 方法 中 完整 地 配置 该 单元 格 。 这 样 做 就 使 得 视图 的 显示 
效果 总 能 与 应 用 程序 的 数据 保持 一 致 ， 从 而 避 开 了 上 次 使 用 单元 格 时 所 残留 下 来 的 状态 信息 。 单 元 格 上 面 的 开关 状态 只 能 影响 这 个 单元 格 的 样 狐 ， 并 不 能 说明 与 其 天 
联 的 那个 逻辑 条 目 也 处 于 打开 状态 。 由 于 可 复 用 的 单元 格 会 保留 上 次 使 用 时 的 受 选 或 未 受 选 状 态 ， 所 以 我 们 必须 修改 accessoryType 属 性 ， 使 其 与 模型 的 状态 相符 ， 而 
不 能 沿用 单元 格 上 次 的 样 狗 。 


解决 方案 9-2 构 建 了 一 份 简单 的 状态 字典 ， 用 以 保存 每 条 索引 路 径 所 对 应 的 开 / 关 状态 。 它 的 数据 源 方 法 会 用 字典 中 的 相关 状态 来 初始 化 单元 格 ， 并 将 其 返回 给 调 
用 者 。 我 们 只 需 稍 稍 扩充 这 条 解决 方案 ， 就 能 把 各 元 素 的 状态 存 入 NSUserDefaults 之 中 ， 以 便 在 下 次 启动 程序 时 恢复 它们 。 这 项 改进 添加 起 来 很 容易 ， 所 以 就 留 给 读 
者 作为 练习 吧 。 


解决 方案 9-2 添加 辅助 视图 并 保存 单元 格 状 态 


// Return a cell populated with data model state for the index path 
- (UITableViewCell *)tableView: (UITableView *)aTableView 
cellForRowAtIndexPath: (NSIndexPath *)indexPath 


UITableViewCell *cell - [self.tableView 
dequeueReusableCellWithIdentifier:G"cell" 
forIndexPath:indexPath]; 


// Cell label 
cell.textLabel.text - items[indexPath.row]; 
BOOL isChecked - 
((NSNumber *)stateDictionary [indexPath] ) .boolValue; 
cell.accessoryType = isChecked ? 


UITableViewCellAccessoryCheckmark : 
UITableViewCellAccessoryNone; 


return cell; 


// On selection, update the title 
- (void)tableView: (UITableView *)aTableView 
didSelectRowAtIndexPath: (NSIndexPath *)indexPath 


UITableViewCell *cell - 
[self.tableView cellForRowAtIndexPath: indexPath] ; 


// Toggle the cell checked state 
BOOL isChecked = 
!((NSNumber *)stateDictionary [indexPath] ) .boolValue; 
stateDictionary [indexPath] = @(isChecked) ; 
cell.accessoryType = isChecked ? 
UITableViewCellAccessoryCheckmark : 
UITableViewCellAccessoryNone; 


// Count the checked items 
int numChecked = 0; 
for (NSUInteger row = 0; row < items.count; row++) 


| 


NSIndexPath *path - 

[NSIndexPath indexPathForRow:row inSection:0]; 
isChecked - 

((NSNumber *)stateDictionary [path] ) .boolValue; 
if (isChecked) numChecked++; 


self.title = [@[@(numChecked).stringValue, @" Checked"] 
componentsJoinedByString:@" "]; 


9.7 ”给 单元 格 添加 详情 展示 控件 


单元 格 右 侧 可 以 出 现 两 种 详情 展示 控件 ， 一 种 是 指向 右 方 的 灰色 V 形 图 案 ， 另 一 种 是 以 tintColor 来 泻 染 的 信息 按钮 (info button) 。 通 过 详情 展示 控件 ， 我 们 可 
以 把 单元 格 与 支持 该 单元 格 的 视图 联系 起 来 。 在 iPhone 和 iPod touch 上 面 的 Contacts 程 序 中 ， 用 户 可 以 在 联系 人 列表 里 点 击 指向 右 方 的 灰色 V 形 图 案 ， 以 编辑 某 个 联 
系 人 的 信息 ， 或 是 在 Calendar 程 序 里 通过 点 击 这 个 图 案 来 安排 某 次 约见 。 图 9-4 演 示 了 两 种 详情 展示 控件 ， 这 张 表格 里 每 个 单元 格 的 右 侧 都 有 详情 展示 控件 。 


在 iPad 上 面 ， 我 们 应 该 考虑 使 用 分 枉 视 图 控制 器 ， 而 不 要 采用 详情 展示 控件 。 因 为 jPad 的 屏幕 空间 较 大 ， 所 以 应 该 把 各 元 素 以 列表 形式 展示 在 屏幕 左边 ， 同 时 把 
细节 视图 展示 在 右边 。 这 样 做 的 效果 与 iPhone 上 面 通过 V 形 详情 展示 控件 想 要 达到 的 效果 是 类 似 的 。 
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图 9-4 指向 右 方 的 灰色 V 形 图 案 与 带 圆 圈 的 i 字 按钮 都 是 详情 展示 控件 ， 用 户 可 以 通过 点 击 它们 来 跳 转 到 另 一 个 视图 
详情 展示 控件 可 以 有 下 面 两 种 样 狐 : 


: UITableViewCellAccessoryDetailDisclosureButton 表 示 外 面 带 有 圆圈 的 1 字 按 钮 ， 按 钮 右 侧 还 有 个 灰色 的 V 形 图 案 。 该 按钮 能 够 追踪 用 户 的 触摸 操作 ， 这 种 按钮 表示 
用 户 点 击 了 单元 格 之 后 ,程序 会 跳 转 到 完全 具备 互动 能 力 的 细节 视图 。 


- UITableViewCellAccessoryDisclosureIndicatotr 表 示 灰 色 的 V 形 图 案 ， 该 图 案 并 不 追踪 触摸 操作 ， 它 表示 用 户 点 击 了 该 单元 格 之 后 ， 程 序 会 跳 转 到 选项 视图 ， 具 体 来 
说 ， 这 个 视图 里 面 会 包含 一 些 与 用 户 所 选单 元 格 有 关 的 选项 。 


iPhone 的 Settings 程 序 里 就 能 看 到 这 两 种 图 案 。 点 击 带 有 扩展 指示 器 (disclosure indicator) 的 WiFi 单 元 格 ， 即 可 切换 到 WiFi 画 面 。 在 这 个 画面 中 ， 我 们 可 以 通 
过 详情 展示 按钮 (detail disclosure)【'j 来 查看 某 个 WiFi 接 入 点 的 具体 信息 ， 包 括 它 的 IP 地 址 、 子 网 掩 码 、 网 关 、DNS 信 息 等 。 


如 果 屏 幕 上 面 将 要 显示 一 份 与 当前 单元 格 有 关 的 子 菜 单 ， 那 么 就 应 该 使 用 扩展 指示 器 。 几 是 要 显示 这 种 子 菜单 的 场合 都 应 该 使 用 简单 的 灰色 V 形 图 案 。 请 记 住 一 条 
经 验 : 灰色 V 形 图 案 用 于 显示 子 荣 单 ， 而 信息 按钮 则 用 于 定制 某 个 对 销 。 如 果 使 用 扩展 指示 器 ， 那 么 程序 代码 束 应 该 响应 用 户 对 单元 格 的 点 击 ;， 若 使 用 详情 展示 按钮 ， 
则 应 响应 用 户 对 该 按钮 的 点 击 。 


下 面 这 段 代码 会 把 每 个 单元 格 的 accessoryType 属 性 都 设 为 UITableViewCell-AccessoryDetailDisclosureButton。 它 还 会 把 editingAccessoryType 属 性 设 为 


UlTableViewCellAccessoryNone: 


- (UITableViewCell *)tableView: (UITableView *)tableView 
cellForRowAtIndexPath: (NSIndexPath *)indexPath 


UITableViewCell *cell - 
[tableView dequeueReusableCellWithIdentifier:@"CustomCell"] ; 


cell.accessoryType - 
UITableViewCellAccessoryDetailDisclosureButton; 
cell.editingAccessoryType - UITableViewCellAccessoryNone; 


return cell; 


// Respond to accessory button taps 
-(void)tableView: (UITableView *)tableView 
accessoryButtonTappedForRowWithIndexPath: (NSIndexPath *)indexPath 


// Do something here 


为 了 处 理 用 户 对 详情 展示 按钮 的 点 击 ， 我 们 需要 在 tableView: accessoryButton-TappedForRowWithlndexPath: 方法 里 面 根据 用 户 所 点 的 行 (row) 来 实现 
一 些 适 当 的 处 理 代 码 。 在 真实 的 应 用 程序 中 ， 上 点 击 了 这 种 按钮 后 ， 程 序 就 会 跳 转 到 另 一 个 视图 ， 那 个 视图 会 详细 解释 当前 所 选 的 这 个 条 目 ， 并 且 会 为 用 户 提供 一 些 额 
外 的 选项 。 


灰色 的 扩展 指示 器 则 要 采用 另 一 套 办 法 来 处 理 。 由 于 这 种 控件 并 不 是 按钮 ， 所 以 我 们 需要 响应 的 应 该 是 用 户 对 单元 格 的 选择 ， 而 不 是 用 户 对 按钮 的 点 击 。 开 发 者 
需要 在 table-View: didSelectRowAtlndexPath: 方法 中 添加 逻辑 代码 ， 把 相关 的 扩展 视图 推 入 导航 栈 ， 另 外 也 可 以 考虑 用 模 态 视图 控制 器 或 警告 视图 来 展示 。 


这 两 种 详情 展示 控件 都 不 会 改变 单元 格 的 其 他 行为 。 殊 算 给 单元 格 添 加 了 此 类 控件 ， 用 尸 也 依然 能 够 对 单元 格 执行 选择 或 编辑 等 操作 。 它 们 只 是 增加 了 一 种 交互 
手段 ， 并 不 会 取代 现 有 的 机 制 。 


[1] 如 果 只 想 显示 带 圆 圈 的 1 字 按 钮 ， 而 不 想 显 示 其 右 侧 的 灰色 V 形 图 案 ， 那 么 应 该 使 用 UITableView-CellAccessoryDetailButton。 译 者 注 


9.8 解决 方案 : 编辑 表格 


添加 编辑 功能 之 后 ， 表 格 束 会 变 得 丰富 起 来 。 编 辑 功 能 可 以 令 表格 里 的 静态 信息 变 成 能 够 滚动 的 互动 式 控件 ， 从 而 使 得 用 己 可 以 添加 或 移 除数 据 。 虽 说 处 理 编辑 
功能 所 需 的 代码 有 些 复 杂 ， 但 同样 的 技术 却 可 以 反复 运用 人 在 各 种 应 用 程序 中 。 我 们 只 要 掌握 了 “进入 编辑 状态 ”、 “离开 编辑 状态 ”以 及 “实现 撤销 功能 ”等 基础 癌 
识 ， 融 可 以 把 它们 移 用 到 其 他 程序 上 面 。 


解决 方案 9-3 制 作 的 这 张 表格 可 以 有 效 地 响应 用 户 的 编辑 操作 。 本 例 创建 了 由 数 张 随机 图 像 所 构成 的 一 份 滚 动 列表 。 用 户 可 以 点 击 Add 按 钮 来 添加 新 的 单元 格 ， 也 
可 以 通过 Swipe (滑动 ) 手势 来 移 除 单 元 格 ， 另外， 点 击 Edit 按 钮 之 后 ， 即 可 进入 编辑 模式 ， 此 时 用 户 可 使 用 红色 的 小 圆 点 来 移 除 单 元 格 (如 图 9-5 所 示 ) 。 
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图 9-5 红色 的 圆 形 控件 使 得 用 户 可 以 交互 式 地 从 表格 中 删除 茶 些 条 目 


在 日 常 使 用 中 ， 每 位 iOS 用 户 都 会 迅速 熟悉 “通过 小 红 点 来 移 除 表 格 单元 格 ” 这 一 操作 方式 。 许 多 用 户 还 会 习惯 “通过 滑动 手势 来 删除 条 目 ” 这 一 功能 。 


除 此 之 


外 ， 本 条 解决 万 案 又 添加 了 一 些 控件 ， 也 就 是 每 个 单元 格 右 侧 那 三 条 灰色 的 横 线 。 用 户 可 通过 该 控件 把 单元 格 拖 忠 到 新 的 位 置 上 。 点 击 Done 按 钮 ， 即 可 离开 编辑 模 


a 


解决 方案 9-3 ”编辑 表格 


@implementation TestBedViewController 


| 


NSMutableArray *items; 


#pragma mark Data Source 
// Number of sections | 
- (NSInteger)numberOfSectionsInTableView: (UITableView *)aTableView 


| 


return 1; 


// Rows per section 
- (NSInteger)tableView: (UITableView *)aTableView 
numberOfRowsInSection: (NSInteger)section 


return items.count; 


// Return a cell for the index path 
- (UITableViewCell *)tableView: (UITableView *)aTableView 
cellForRowAtIndexPath: (NSIndexPath *)indexPath 


UITableViewCell *cell - [self.tableView 
dequeueReusableCellWithIdentifier:@"cell" 
forIndexPath: indexPath] ; 

cell.imageView.image = items [indexPath.row] ; 

return cell; 


#pragma mark Edits 
- (void) setBarButtonItems 
| 
// Expire any ongoing operations 
if (self.undoManager.isUndoing || 
self.undoManager.isRedoing) 


[self performSelector:Gselector(setBarButtonItems) 


withObject:nil afterDelay:0.1f]; 
return; 


UIBarButtonItem *undo - SYSBARBUTTON TARGET( 


UIBarButtonSystemItemUndo, self.undoManager, 
@selector (undo) ) ; 
undo.enabled = self .undoManager.canUndo; 
UIBarButtonItem *redo = SYSBARBUTTON TARGET ( 
UIBarButtonSystemItemRedo, self.undoManager, 
@selector (redo) ) ; 
redo.enabled = self.undoManager.canRedo; 
UIBarButtonItem *add = SYSBARBUTTON ( 
UIBarButtonSystemItemAdd, @selector(addItem:)) ; 


self.navigationlItem.leftBarButtonItems = G[add, undo, redo]; 


- (void) setEditing: (BOOL)isEditing animated: (BOOL) animated 

{ 
{super setEditing:isEditing animated:animated] ; 
[self.tableView setEditing:isEditing animated:animated] ; 


NSIndexPath *path = [self.tableView indexPathForSelectedRow] ; 
if (path) 
[self.tableView deselectRowAtIndexPath:path animated: YES] ; 


[self setBarButtonItems] ; 


- (void) updateItemAtIndexPath: (NSIndexPath *) indexPath 
withObject: (id) object 


// Prepare for undo 

id undoObject = 
object ? nil : items [indexPath.row] ; 

[ [self .undoManager prepareWithInvocationTarget:self] 
updateltemAtIndexPath:indexPath withObject:undoObject]; 


// You cannot insert a nil item. Passing nil is a delete request. 
(self.tableView beginUpdates]; 
if (!object) 
{ 
[items removeObjectAt Index: indexPath. row] ; 
[self.tableView deleteRowsAt IndexPaths:@ [indexPath] 
withRowAnimation:UITableViewRowAnimationTop] ; 


else 


[items insertObject:object atIndex:indexPath.row] ; 
[self.tableView insertRowsAt IndexPaths:@ [indexPath] 
withRowAnimation:UITableViewRowAnimationTop] ; 
j 
[self.tableView endUpdates]; 
[self performSelector:Gselector(setBarButtonItems) 
withObject:nil afterDelay:0.1f]; 


(void) addItem: (id) sender 


// add a new item 
NSIndexPath *newPath = 
[NSIndexPath indexPathForRow:items.count inSection:0] ; 
UIImage *image = blockImage (IMAGE SIZE); 
[self updateItemAtIndexPath:newPath withObject:image] ; 


(void)tableView: (UITableView *) aTableView 
commitEditingStyle: (UITableViewCellEditingStyle) editingStyle 
forRowAtIndexPath: (NSIndexPath *) indexPath 


// delete item 
[self updateItemAtIndexPath:indexPath withObject:nil] ; 


// Provide re-ordering support 

-(void)tableView: (UITableView *)tableView 
moveRowAtIndexPath: (NSIndexPath *)oldPath 
toIndexPath: (NSIndexPath *)newPath 


if (oldPath.row -- newPath.row) return; 


[[self.undoManager prepareWithInvocationTarget:self] 
tableView:self.tableView moveRowAtIndexPath:newPath 
tolndexPath:oldPath]; 


id item - [items objectAtIndex:oldPath.row]; 
[items removeObjectAtIndex:oldPath.row]; 
[items insertObject:item atIndex:newPath.row]; 


if (self.undoManager.isUndoing || self.undoManager.isRedoing) 
( 
[self.tableView beginUpdates]; 
[self.tableView deleteRowsAtIndexPaths:@[oldPath] 
withRowAnimation:UITableViewRowAnimationLeft]; 
([self.tableView insertRowsAtIndexPaths:@{newPath] 
withRowAnimation:UITableViewRowAnimationLeft]; 
[self.tableView endUpdates]; 
} 
[self performSelector:@selector (setBarButtonItems) 
withObject:nil afterDelay:0.1f]; 


#pragma mark First Responder for undo support 
- (BOOL) canBecomeFirstResponder 


{ 


return YES; 


- (void)viewDidAppear: (BOOL)animated 


[super viewDidAppear:animated]; 
[self becomeFirstResponder]; 


- (void)viewWillDisappear: (BOOL)animated 


[super viewWillDisappear:animated]; 
[self resignFirstResponder] ; 


#pragma mark View Setup 
- (void) viewDidLoad 


| 


[super viewDidLoad] ; 
self.view.backgroundColor = [UIColor whiteColor] ; 


[self.tableView registerClass: [UITableViewCell class] 
forCellReuseIdentifier:@"cell"] ; 

self.tableView.rowHeight = IMAGE SIZE + 20.0f; 

self.tableView.separatorStyle = 
UITableViewCellSeparatorStyleNone; 

self.navigationItem.rightBarButtonlItem = self.editButtonItem; 


items = [NSMutableArray array]; 


// Provide shake to undo support 
[UIApplication sharedApplication] .applicationSupportsShakeToEdit = YES; 
[self setBarButtonItems] ; 


@end 


9.8.1 添加 撤销 功能 
Cocoa Touch 所 提供 的 NSUndoManager 类 可 用 来 反 转 用 户 的 操作 。 在 默认 情况 下 ， 每 个 应 用 程序 的 视窗 都 会 提供 一 份 共享 的 撤销 管理 器 。 开 发 者 可 以 使 用 这 份 
共享 的 管理 器 ， 也 可 以 自己 创建 新 的 。 


UIResponder 类 的 所 有 子 类 都 能 找到 听 应 链 中 最 近 的 那个 撤销 管理 器 。 这 融 是 况 ， 如 果 在 视图 控制 器 中 使 用 视窗 的 NSUndoManager， 那 么 只 需 通过 控制 器 的 
undoManager 属 性 ， 融 能 找到 那个 NSUndoManager 了 。 这 是 个 很 方便 的 特性 ， 因 为 开 上 友 者 只 需 给 主 视 图 控制 器 添加 撤销 功能 ， 融 能 令 其 中 的 所 有 子 视 图 目 动 具 备 
该 功能 。 


撤销 管理 器 里 面 可 以 保存 任意 数量 的 撤销 动作 (undo action) 。 开 发 者 可 以 指定 栈 的 深度 。 栈 越 深 ， 所 用 内 存 就 越 多 。 许 多 程序 在 内 存 比较 紧张 时 都 只 支持 3、5 
或 10 级 撤销 。 栈 中 的 每 个 动作 既 可 以 是 由 许多 撤销 操作 所 组 成 的 复杂 动作 ， 又 可 以 是 像 解决 方案 9-3 所 演示 的 那 种 简单 动作 。 


本 条 解决 方案 用 撤销 管理 器 来 实现 与 “添加 单元 格 ”、 “删除 单元 格 ” 以 及 “移动 单元 格 ” 这 三 种 操作 有 关 的 撤销 及 重 做 功能 。 用 户 可 通过 Undo 和 Redo 按 钮 在 
目 己 的 编辑 历程 乙 中 游 走 。 本 条 解决 方案 会 根据 撤销 管理 器 所 能 提供 的 动作 来 局 用 当前 可 供 使 用 的 按钮 。 


9.8.2 ”实现 撤销 功能 


解决 方案 9-3 及 用 同一 个 方法 来 添加 及 移 除 条 目 ， 这 个 方法 就 是 updateltemAtindex-Path: withObject: 。 此 方法 的 运作 方式 为 : 如 果 传 入 的 对 象 不 是 nil， 那 么 
就 把 它 插入 到 索引 路 径 中 ; 如 果 是 nil， 则 把 位 于 该 索引 路 径 处 的 条 目 删 除 。 


这 样 处 理 用 户 的 请 求 似乎 有 点 奇怪 ， 因 为 我 们 需要 编写 一 个 方法 ， 而 且 在 方法 里 还 要 做 一 次 判断 ， 不 过 这 样 做 其 背后 是 有 原因 的 。 这 种 做 法 能 够 为 撤销 功能 提供 
统一 的 基础 代码 ， 使 得 开 友 者 可 以 更 加 方便 地 将 其 同 撤销 管理 器 相 集 成 。 


因此 ， 该 方法 有 两 件 事 情 要 做 。 首 先 ， 它 会 准备 好 与 撤销 操作 有 天 的 行为 。 也 融 是 说 ， 它 会 告诉 撤销 管理 器 目前 所 运用 的 这 项 编辑 操作 将 来 应 该 如 何 还 原 。 其 
次 ， 它 要 执行 实际 的 编辑 操作 ， 也 就 是 修改 items 数 组 、 更 新 表格 ， 并 更 新 导航 栏 中 的 按钮 。 


setBarButtonltems 方 法 要 控制 Undo 与 Redo 按 钮 的 状态 。 该 方法 会 检查 当前 正在 活动 的 撤销 管理 器 ， 看 看 撤销 枝 中 是 否 提供 了 能 够 撤销 及 能 够 重 做 的 动作 。 如 果 
有 ， 就 局 用 相应 的 按钮 。 


时 说 笔者 并 不 喜欢 用 晃动 撤销 (shake-to-undo) 功能 ,但 本 条 解决 方案 依然 提供 了 这 一 功能 。 它 在 viewDidLoad 方 法 里 面 把 应 用 程序 委托 的 
applicationSupportsshakeToFEdit 属 性 设 为 YES。 另 外 也 请 大 家 注意 ， 为 了 实现 撤销 功能 ， 我 们 调用 了 与 第 一 响应 者 有 关 的 两 个 方法 。 当 表格 视图 即将 出 现在 屏幕 上 
面 时 ， 令 其 变 为 第 一 响应 者 ， 而 当 它 要 从 屏幕 中 消失 时 ， 则 令 其 放弃 第 一 响应 者 的 身份 。 


9.8.3 ”显示 移 除 单元 格 所 用 的 控件 


调用 [self.tableView setEditing: YES animated: YES] 方 法 ， 即 可 令 表 格 把 移 除 单元 格 所 用 的 控件 显示 出 来 。 这 会 更 新 表格 的 editing 属 性 ， 并 且 会 在 每 个 单元 格 
里 显示 出 图 9-5 那 样 的 红色 移 除 控 件 。 动 画 效 果 是 可 选 的 ， 不 过 笔者 建议 将 它 打开 。 有 一 条 经 验 : 如 果 要 把 程序 从 一 个 状态 切换 到 另 一 个 状态 ， 那 么 应 该 在 iOS 界 面 中 
展示 动画 效果 ， 使 得 用 户 意 识 到 屏幕 上 的 状态 正在 变化 。 


解决 方案 9-3 采 用 了 系统 所 提供 的 Edit/Done 按 钮 (self.editButtonltem) ， 并 实现 了 setEditing: animated: 方法 ， 使 得 表格 可 以 进入 并 离开 编辑 状态 。 用 户 氮 
击 Edit 或 Done 按 钮 时 (按钮 文本 会 在 这 两 者 之 间 切 损 ) ， 访 万 法 会 更 新 表格 的 编辑 状态 以 及 导航 栏 上 的 按钮 。 


9.8.4 处理 删除 请 求 


删除 表 中 的 某 一 行 时 ， 表 格 会 执行 tableView: commitEditingStyle: forRowAt-IndexPath: 回调 ， 以 便 将 这 一 操作 告知 应 用 程序 。 从 表格 上 移 除 某 个 条 目 只 是 
令 其 不 显示 出 来 ， 这 并 不 会 修改 底层 的 数据 。 除 非 开 发 者 把 这 个 条 目 也 从 数据 源 里 移 除 ， 否 则 下 次 刷新 表格 的 时 候 ， 这 个 已 删除 的 条 目 还 是 会 显示 出 来 。 我 们 可 以 在 
该 方法 里 协调 表格 与 数据 源 之 间 的 关系 ， 并 对 “用 户 想 要 删除 这 一 行 ”的 请 求 做 出 响应 。 


在 本 例 中 ， 我 们 可 以 从 给 数据 源 方法 提供 内 容 的 数据 结构 里 (也 就 是 包含 各 图 像 的 那个 NSMutableArray) 删除 一 项 条 目 ， 而 在 真实 的 应 用 程序 中 ， 则 可 以 执行 诸 
如 删除 文件 或 移 除 联系 人 等 操作 ， 以 响应 用 户 的 编辑 请 求 。 


解决 方案 9-3 会 用 动画 效果 来 展示 单元 格 的 删除 过 程 。 我 们 可 以 把 添加 某 行 及 删除 某 行 等 操作 放 在 beginUpdates 方 法 之 后 ， 并 放 在 配套 的 endUpdates 方 法 之 
前 ， 从 而 令 系 统 能 够 以 动画 效果 来 同时 展示 这 些 操作 。 


9.8.5 ”通过 滑动 手势 删除 单元 格 
要 想 从 UITableView 实 例 中 移 除 条 目 ，Swipe 手 势 是 个 很 简洁 的 办 法 。 只 需 实 现 tableView: commitEditingStyle: forRowAtIndexPath: 方法 ， 即 可 启用 Swipe 
功能 。 表 格 会 处 理 好 剩 下 的 事情 。 


用 户 将 某 个 单元 格 从 右 方 迅速 向 左 方 拒 咏 ， 这 就 是 针对 单元 格 的 Swipe 手 势 。 单 元 格 右 侧 会 显示 出 长 方形 的 Delete 按 钮 ， 用 以 确认 此 操作 ， 不 过 左 侧 并 不 会 出 现 表 
示 移 除 单元 格 功能 的 那个 红色 圆 形 控件 。 


当 用 户 执 行 Swipe 操 作 并 确认 之 后 ， 我 们 就 可 以 在 tableView: commitEditing-Style: forRowAtIndexPath: 方法 里 更 新 数据 了 ， 这 与 在 编辑 模式 下 删除 单元 格 
是 一 样 的 。 


9.8.6 ”调整 时 元 格 的 | 顺序 


如 果 能 直接 调整 表格 中 各 单元 格 的 顺序 ， 用 户 就 可 以 获得 更 大 的 自由 度 了 。 图 9-5 所 演示 的 这 张 表格 里 有 很 多 调整 单元 格 顺 序 所 用 的 控件 ， 这 种 控件 是 三 条 上 下 蔷 
放 的 灰色 线段 。 用 户 可 以 通过 重 排 单元 格 顺 序 来 调整 各 项 待 办 事务 的 优先 级 ， 或 是 在 播放 清单 中 选择 首先 要 听 的 歌曲 等 。iOS 的 表格 内 置 了 重 排 单元 格 顺 序 这 一 功能 ， 
开 友 者 很 容易 融 能 将 其 集成 到 应 用 程序 中 。 


与 通过 滑动 手势 删除 单元 格 一 样 ， 单 元 格 重 排 功能 是 否 局 用 也 取决 于 开发 者 是 否 实现 了 某 个 方法 。 这 个 方法 就 是 tableView: moveRowAtindexPath: 


tolndexPath， 它 可 以 将 表格 的 数据 源 与 屏幕 上 所 友 生 的 变化 相同 步 ， 这 与 删除 单元 格 时 回调 的 tableView: commitEditingStyle: forRowAtIndexPath: 方法 类 
似 。 添 加 这 一 方法 即 可 调整 单元 格 顺序 。 


9.8.7 ”添加 单元 格 


解决 方案 9-3 用 Add 按 钮 来 为 表格 添加 新 内 容 。 该 按钮 是 \OS 系 统 内 置 的 UIBar-Buttonltem， 它 的 样子 是 个 加 号 。 (参见 图 9-5 左 上 角 。) 解决 方案 9-3 中 的 
addltem: 方法 会 向 ittems 数 组 末端 追加 一 张 新 的 随机 图 像 。 


9.9 解决 方案 : 操控 表格 的 区 段 


许多 iOS 应 用 程序 使 用 区 段 (section) 来 划分 各 行 。 区 段 是 在 列表 中 划分 小 区 域 的 方式 ， 它 把 条 目 按照 逻辑 组 织 成 单元 。 最 音 用 的 分 区 方式 是 首 字 母 分 区 法 ， 当 
然 开 上 友 者 并 不 一 定 非 要 这 么 组 织 数 据 。 你 可 以 选择 与 应 用 程序 相 匹 配 的 任意 分 区 方式 。 


Crayon names starting with 'R' 
meu urange 


Hazzmatazz 

Red Violet 
Robin s Egg Blue 
Haw Sienna 


Razzle Dazzle Rose 
Crayon names starting with 'S' 
Scarlet 


Silver 


Sunglow 


图 9-6 ”分 区 后 的 表格 会 显示 出 区 段 的 头 部 标题 ， 也 会 提供 索引 ， 使 得 用 户 可 以 迅速 跳 转 到 各 个 区 段 


-«mc-aommuozz-ce-—-zrmgoommoou-or 


图 9-6 演 示 的 这 张 表 格 会 把 各 种 颜色 名 称 分 组 显示 在 不 同 的 区 段 里 。 每 个 区 段 都 会 显示 各 自 的 头 部 标题 (也 就 是 “Crayon names starting 
withhttp://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15137/OEBPS/Text/...” 形 式 的 一 段 文本 ) ， 表 格 右 
侧 的 索引 可 以 快速 跳 转 到 各 个 区 段 。 请 注意 ， 索 引 里 面 没有 列 出 与 K、Q、X 及 Z 相 对 应 的 区 段 ， 因 为 那些 区 段 是 空 的 。 通 常 我 们 都 想 把 索引 中 的 空 区 段 隐 藏 起 来 。 


9.9.1 构建 区 段 


构建 分 组 和 分 区 时 ， 要 把 它们 理解 成 二 维 数 组 。 开 发 者 可 以 创建 名 叫 sectionArray 的 二 维 数组 ， 来 存储 并 访问 数据 结构 中 各 个 分 区 里 的 数据 。 我 们 需要 创建 含有 数 
组 的 数组 。sectionArray 里 可 以 存储 与 每 个 分 区 相对 应 的 小 数组 ， 而 那个 小 数组 里 面 又 会 包含 该 分 区 每 个 单元 格 的 标题 。 


通过 谓词 ， 我 们 可 以 用 一 系列 字符 串 来 构建 区 段 。 借 助 下 面 这 个 方法 ， 开 发 者 可 以 把 普通 数组 中 以 某 个 字母 开头 的 那些 字符 串 都 划分 到 一 起 。beginswith 这 个 谓 
词 能 够 匹配 以 给 定 字 母 起 头 的 字符 串 : 


- (NSArray *)itemsInSection: (NSInteger)section 


NSPredicate *predicate = [NSPredicate predicateWithFormat: 
@"SELF beginswith[cd] $8", [self firstLetter:section]]; 

return [crayonColors.allKeys 
filteredArrayUsingPredicate:predicate]; 


反复 调用 上 述 方法 ， 并 把 每 次 返回 的 结果 数组 都 添加 到 一 个 可 变 的 数组 里 面 ， 这 样 就 能 根据 一 份 普通 的 列表 创建 出 二 维 的 sectionArray 数 组 : 


sectionArray = [NSMutableArray array]; 
for (int i = 0; 1 < 26; i++) 


[sectionArray addObject: [self itemsInSection:i]]; 


这 种 实现 方式 要 想 正 确 运 作 ， 必 须 满足 两 个 条 件 。 首 先 ， 各 单词 必须 排 好 顺序 (每 个 词 在 区 段 里 出 现 的 先后 顺序 与 其 在 原 数组 里 出 现 的 先后 顺序 相同 ) ， 其 次 ， 
区 段 和 该 区 段 中 的 单词 必须 相符 。 上 面 这 段 循 环 代码 无 法 处 理 以 符号 或 数组 开头 的 词 。 然 而 我 们 只 需 添加 other (其 他 ) 区 段 ， 即 可 将 这 些 单词 归 为 一 组 ， 不 过 由 于 本 
条 解决 方案 比较 简单 ， 所 以 笔者 融 把 对 这 些 单词 的 处 理 省 略 反 了 。 


刚才 说 过 ， 按 照 首 字母 来 分 组 是 最 常用 的 一 种 分 组 方式 ， 不 过 ， 你 也 可 以 及 用 其 他 分 组 方式 。 比 方 说 ， 可 以 按照 部 门 来 划分 人 员 ， 按 照 等 级 来 划分 宝石 或 按照 日 
期 来 划分 约会 。 无 论 选用 何 种 分 组 方式 ， 以 二 维 数 组 来 充当 这 种 分 区 表格 的 数据 源 都 是 非常 合适 的 。 


对 于 这 个 简单 的 范例 来 说 ， 可 以 使 用 二 维 数组 这 种 结构 来 添加 或 移 除 条 目 。 不 过 读者 很 容易 就 能 友 现 ， 用 这 种 方式 添加 数据 虽然 简单 ， 但 维护 起 来 却 有 点 麻烦 ， 
而 这 正 是 Core Data 能 够 派 上 用 场 的 地 方 。 使 用 了 Core Data 之 后 ， 我 们 丈 不 用 表 处 理 多 层 数 组 了 ， 而 是 可 以 在 数据 库 中 查询 与 任意 的 对 象 字段 有 关 的 信息 ， 并 且 按 照 
需要 对 其 排序 。 第 12 章 会 介绍 如 何 将 Core Data 与 表格 结合 起 来 使 用 。 等 阅读 了 那 一 章 你 融会 友 现 ，Core Data 极 大 地 简化 了 编程 工作 。 目 前 这 个 范例 依然 使 用 简单 的 
二 维 数组 来 介绍 区 段 及 其 用 法 。 


9.9.2 ”区 段 数 量 与 区 段 内 的 行 数 


若 想 创建 分 区 的 表格 ， 需 要 定制 下 面 这 两 个 关键 的 数据 源 方法 : 


. numberOfSectionsInTableView: 


该 方法 返回 表格 中 将 要 出 现 的 区 段 数量 ， 也 就 是 表格 要 把 其 中 的 条 目 分 成 多 少 个 组 来 显示 。 如 果 使 用 笔者 所 推荐 的 这 种 
sectionArray， 那 么 就 应 该 返回 该 数组 里 的 元 素 个 数 ， 也 就 是 sectionAtray.count。 如 果 数 组 中 的 元 素 个 数 可 以 提前 确定 (例如 在 本 例 中 ， 尽 管 某 些 区 段 里 没有 和 条目， 但 我 


们 可 以 确定 元 素 个 数 是 26) , 那么 可 将 其 用 “ 硬 数值 ”的 形式 写 在 代码 里 面 ， 不 过 ， 代 码 还 是 尽量 写 得 通用 一 些 比较 好 。 


: tableView: numberOfRowslnSection: 一 一 系统 会 以 区 段 编 号 为 参数 来 调用 该 方法 。 开 发 者 需要 指定 出 现在 该 区 段 中 的 行 数 。 如 果 采 用 笔者 推荐 的 


sectionAtray， 那 么 就 应 该 返回 第 n 个 小 数组 里 的 元 素 个 数 : 


sectionArray [sectionNumber].count 


9.9.3 ”返回 单元 格 


分 区 的 表格 需要 通过 行 和 分 区 这 两 种 信息 来 确定 单元 格 数据 。 本 章 早 前 那 条 解决 方案 有 用 普通 的 一 维 数组 ， 以 下 标 来 表示 行 号 。 市 分 区 的 表格 必须 用 完整 的 索引 


路 径 来 确定 区 段 及 行 的 序号 ， 以 此 找到 填充 单元 格 所 用 的 数据 。 下 面 这 个 方法 写 在 名 为 CrayonHandler 的 辅助 类 中 ， 它 首先 根据 区 段 取 出 对 应 的 currentltems 数 组 ， 
然后 再 根据 行 来 寻找 具体 的 条 目 。 如 果 用 二 维 数组 来 表示 分 区 表格 的 数据 源 ， 那 么 就 可 以 使 用 解决 方案 9-4 中 的 这 个 CrayonHandler 辅 助 类 了 ， 下 面 详 细 列 出 该 类 
colorNameAtlndexPath ; 方法 的 代码 : 


// Color name by index path 
- (NSString *)colorNameAtIndexPath: (NSIndexPath *)path 
if (path.section »- sectionArray.count) 
return nil; 
NSArray *currentItems = sectionArray [path.section]; 


if (path.row >= currentItems.count) 


return nil; 
NSString *crayon - currentItems[path.row]; 


return crayon; 


还 有 个 相似 的 方法 用 于 获取 单元 格 的 颜色 : 


// Color by index path 
- (UIColor *)colorAtIndexPath: (NSIndexPath *)path 
{ 
NSString *crayon = [self colorNameAtIndexPath:path] ; 
if (crayon) 
return crayonColors [crayon] ; 
return nil; 


下 面 这 个 数据 源 方法 通过 调用 上 述 两 方法 来 返回 具备 适当 颜色 和 适当 名 称 的 单元 格 : 


// Return a cell for the index path 
- (UITableViewCell *)tableView: (UITableView *)aTableView 
cellForRowAtIndexPath: (NSIndexPath *)indexPath 


UITableViewCell *cell - 
[self.tableView dequeueReusableCellWithIdentifier:@"cell" 
forIndexPath: indexPath] ; 


// Retrieve the crayon name 
NSString *crayonName = [crayons colorNameAtIndexPath: indexPath] ; 


// Update the cell 
cell.textLabel.text = crayonName; 


// Tint the title 
if ([crayonName hasPrefix:@"White"] ) 
cell.textLabel.textColor = [UIColor blackColor] ; 
else 
cell.textLabel.textColor = [crayons colorAtIndexPath: indexPath] ; 


return cell; 


解决 方案 9-4 ”实现 市 有 若干 区 段 的 表格 


/* CrayonHandler.m */ 
// Return an array of items that appear in each section 
- (NSArray *)itemsInSection: (NSInteger)section 
{ 
NSPredicate *predicate = [NSPredicate predicateWithFormat: 
@"SELF beginswith[cd] %@", [self firstLetter:section] ]; 
return [[crayonColors allKeys] filteredArrayUsingPredicate:predicate] ; 


// Count of available sections 
- (NSInteger)numberOfSections 


人 


return sectionArray.count; 


// Number of items within a section 
- (NSInteger)countInSection: (NSInteger)section 


| 
| 


// Return the letter that starts each section member's text 
- (NSString *)firstLetter: (NSInteger)section 


{ 


return [sectionArray[section] count]; 


return [[ALPHA substringFromIndex:section] substringToIndex:1]; 


// The one-letter section name 
- (NSString *)nameForSection: (NSInteger)section 
if (![self countInSection:section] ) 
return nil; 
return [self firstLetter:section] ; 


// Color name by index path 
- (NSString *)colorNameAtIndexPath: (NSIndexPath *)path 
if (path.section >= sectionArray.count) 
return nil; 
NSArray *currentItems = sectionArray[path.section]; 


if (path.row >= currentItems.count) 
return nil; 
NSString *crayon = currentItems[path.row]; 


recurn crayon; 


// Color by index path 

- (UIColor *)colorAtIndexPath: (NSIndexPath *)path 

{ 
NSString *crayon = [self colorNameAtIndexPath: path] ; 
return crayonColors [crayon] ; 


9.9.4 ”创建 每 个 区 段 的 头 部 标题 


石 要 给 分 区 表格 中 的 每 个 区 段 头 部 添加 标题 ， 


则 需 稍 微 多 写 一 些 代 码 。 开 发 者 可 以 通过 名 为 tableView: titleForHeaderlnSection: 的 可 选 方法 给 每 个 区 段 提 供 


标题 。 系 统 会 给 该 方法 传 入 一 个 整数 ， 而 开发 者 则 应 该 提供 对 应 的 标题 。 如 果 给 定 的 区 段 里 没有 任何 条 目 ， 或 是 整 张 表 个 只 有 一 个 区 段 ， 那 么 束 返 回 nil: 


// Return the header title for a section 
- (NSString *)tableView: (UITableView *)aTableView 
titleForHeaderInSection: (NSInteger)section 


NSString *sectionName - [crayons nameForSection:section]; 
if (!sectionName) return nil; 
return [NSString stringWithFormat: 


@"Crayon names starting with '%@'", sectionName]; 


| 


假如 不 想 使 用 标题 ， 那 么 可 以 返回 上 自 定义 的 头 部 视图 。 


9.9.5 ”定制 表格 与 区 段 的 头 部 及 尾部 


分 区 的 表格 视图 特别 容易 定制 其 内 容 。 开 发 者 可 以 把 任意 类 型 的 视图 赋 给 table-HeaderView 属 性 以 及 与 其 相关 的 tableFooterView 属 性 ， 每 个 视图 都 可 以 有 自己 
的 子 视图 。 于 是 ， 我 们 可 以 添加 标签 、 文 本 框 、 按 钮 以 及 其 他 控件 ， 以 此 来 丰富 表格 的 特性 。 


每 张 表格 并 不 是 只 能 有 一 个 头 部 (header) 和 尾部 (footer) 。 每 个 区 段 都 提供 了 可 以 定义 的 头 部 视图 及 尾部 视图 。 你 可 以 改变 区 段 头 部 的 高 度 ， 或 将 其 中 的 元 
件 改 成 自己 定制 的 视图 。 可 选 的 tableView: heightForHeaderlnSection: 方法 (或 sectionHeaderHeight 属 性 ) 及 tableView: viewForHeaderlnSection: 方法 使 
得 开 友 者 能 够 单独 指定 每 个 分 区 的 头 部 。 对 于 分 区 的 尾部 来 说 ， 也 有 对 应 的 一 套 方 法 。 


9.9.6 创建 区 段 系 引 


SEH f sectionIndexTitlesForTableView: 方法 的 表格 可 以 展示 出 图 9-6 右 侧 那 样 的 索引 视图 。 系 统 创建 表格 视图 的 时 候 会 调用 这 个 方法 ， 而 开发 者 所 返回 的 数组 
则 决定 了 显示 在 屏幕 上 面 的 索引 条 目 。 返 回 nil 就 表示 不 需要 显示 索引 。 苹 果 公司 建议 只 给 普通 样式 的 表格 视图 添加 区 段 索引 ， 也 就 是 癌 ， 只 应 该 给 使 用 
UITableViewstylePlain 样 式 的 表格 添加 索引 ， 而 不 应 该 给 UITableViewstyleGrouped 样 式 的 表格 添加 : 


// Return an array of section titles for index 
- (NSArray *)sectionIndexTitlesForTableView: (UITableView *)aTableView 


{ 


NSMutableArray *indices = [NSMutableArray array]; 
for (int i = 0; i « crayons.numberOfSections; i++) 


| 


NSString *name = [crayons nameForSection:1] ; 
if (name) [indices addObject:name]; 


} 


return indices; 


虽说 本 例 采 用 单个 字母 作为 分 区 索引 的 标题 ， 但 你 并 不 一 定 非 要 受 此 限制 。 开 友 者 也 可 以 把 单词 或 是 用 Unicode 编 码 来 表示 的 符号 当成 标题 ， 例 如 ， 可 以 在 索引 
里 使 用 emoji 表 情 符号 ， 它 们 也 是 1O0S 字 符 库 的 一 部 分 。 下 面 这 行 代码 可 以 给 索引 里 添加 一 张 黄 颜色 的 小 笑脸 符号 : 


[indices addObject:@"\ue057"] ; 


9.9.7 ”处 理 系 引 与 区 段 不 匹配 的 问题 


用 尸 点 击 表格 的 索引 时 ， 表 格 会 根据 用 尸 触摸 点 的 偏 移 量 来 滚动 。 正 如 本 节 早 前 所 述 ， 这 张 表格 的 索引 里 并 没有 显示 出 K、Q、X 及 Z 区 段 。 由 于 缺 了 这 几 个 字母 ， 
所 以 用 尸 在 这 引 中 点 选 的 字母 会 与 表格 实际 显示 出 来 的 区 段 不 相符 。 


为 了 解决 此 问题 ， 我 们 需要 实现 可 选 的 tableView: sectionForSectionIndexTitle: 方法 。 该 方法 负责 把 区 段 索 引 的 标题 (也 就 是 由 
sectionIndexTitlesForTableView: 方法 所 返回 的 字符 串 ) 和 区 段 编号 对 应 起 来 。 这 样 就 能 把 原 有 的 不 匹配 情况 覆盖 掉 ， 并 且 会 在 用 户 所 选 的 索引 字母 区 段 和 表格 要 显 
示 的 区 段 之 间 建 立 起 准确 的 一 一 对 应 关系 : 


#define ALPHA G"ABCDEFGHIJKLMNOPQRSTUVWXYZ" 

- (NSInteger)tableView: (UITableView *)tableView 
sectionForSectionIndexTitle: (NSString *)title 
atIndex: (NSInteger)index 


return [ALPHA rangeOfString:title].location; 


9.9.8 ”为 分 区 表格 实现 委托 万 法 


与 数据 源 方法 一 样 ， 为 分 区 表格 实现 UITableViewDelegate 协 议 中 的 tableView: didSelectRowAtindexPath: 方法 时 ， 也 需要 使 用 索引 路 径 中 的 section 和 row 
属性 。 本 例 中 ， 我 们 可 以 通过 这 两 个 属性 在 sectionArray 数 组 里 找到 与 当前 区 段 对 应 的 小 数组 ， 并 在 小 数组 里 找到 用 户 所 点 选 的 条 目 : 


// On selecting a row, update the navigation bar tint 
- (void)tableView: (UITableView *)aTableView 
didSelectRowAtIndexPath: (NSIndexPath *)indexPath 


UIColor *color - [crayons colorAtIndexPath:indexPath]; 
self.navigationController.navigationBar.barTintColor - color; 


910 解决 方案 : 在 表格 中 搜索 


搜索 显示 控制 器 可 以 实现 由 用 户 所 主导 的 搜索 操作 。 这 些 控制 器 使 得 用 户 能 够 实时 地 过 滤 表 格 内 容 ， 而 表格 则 会 根据 用 户 所 输入 的 查询 信息 立即 做 出 响应 。 这 项 
功能 很 好 ， 它 使 得 用 尸 可 以 交互 式 地 找寻 自己 想 要 的 内 容 ， 每 次 在 搜索 框 中 输入 新 字符 时 ， 搜 索 结 果 都 会 立刻 更 新 。 


创建 这 种 控制 器 的 时 候 ， 需 要 用 搜索 栏 实例 和 内 容 控制 器 来 初始 化 已 ， 这 个 内 容 控制 器 通常 是 表格 视图 ， 用 户 所 要 查询 的 数据 束 存 放 在 表格 的 数据 源 之 中 。 解 决 
方案 9-5 演 示 了 在 应 用 程序 中 创建 并 使 用 搜索 显示 控制 器 时 所 需 的 步骤 。 


搜索 功能 最 好 通过 谓词 来 构建 ， 这 样 的 话 ， 只 需 调 用 一 个 简单 的 方法 ， 即 可 在 数组 上 面 进行 过 滤 ， 并 获取 到 与 待 搜索 内 容 相 匹配 的 条 目 。 下 面 我 们 来 演示 如 何在 
普通 的 字符 串 数 组 里 获取 与 搜索 栏 中 的 文本 相 匹 配 的 字符 串 。contains 后 面 的 [cd] 表 示 匹 配 的 时 候 既 不 区 分 大 小 写 ， 也 不 区 分 附加 符号 (diacritic) 。 附 加 符号 是 与 字 
母 相伴 的 小 标记 ， 比 方 说 表示 变 音 的 那 两 个 点 (umlaut, 7) ， 或 是 西班牙 语 字 母 nM 上方 的 波浪 线 (tilde, ~) 。 


NSPredicate *predicate = 
[NSPredicate predicateWithFormat:@"SELF contains[cd] $6", 
searchBar.text]; 
filteredArray - [[crayonColors allKeys] 
filteredArrayUsingPredicate:predicatel; 


本 例 中 的 搜索 栏 应 该 作为 头 部 视图 (header view) 出 现在 表格 项 端 ， 如 图 9-7 左 侧 截 图 所 示 。 在 下 面 这 段 代码 中 ， 我 们 还 需要 用 这 个 搜索 栏 来 配置 搜索 显示 控制 
ES: 
self.tableView.tableHeaderView = searchBar; 


searchController - [[UISearchDisplayController alloc] 
initWithSearchBar:searchBar contentsController:self]; 
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图 9-7 ”开始 搜索 时 ， 必 须 滚动 到 表格 顶部 。 作 为 头 部 视图 的 搜索 栏 会 出 现在 表格 中 的 首 个 位 置 上 〈 如 左 侧 蕉 图 所 示 ) 。 用 户 点 击 搜索 栏 之 后 ， 就 会 将 其 激活 ， 此 时 搜 
索 栏 会 跳 到 导航 栏 里 ， 而 表格 则 会 根据 用 户 输入 的 搜寻 标准 来 展示 与 之 匹配 的 条 目 〈 如 右 侧 堆 图 所 示 ) 


iOS 7 的 搜索 栏 可 以 通过 searchBarStyle 属 性 来 配置 其 样 狐 ， 该 属性 的 取 值 可 以 是 UlSearchBarStyleProminent、UlSearchBarStyleMinimal 或 UlSearchBar- 
StyleDefault。UlSearchBarStyleProminent 就 是 默认 的 样式 (UlSearchBarStyle-Default) ， 这 种 样式 的 背景 是 半 透 明 的 ， 搜 索 框 是 完全 不 透明 的 ， 这 与 早 前 iOS 版 
本 中 的 风格 相符 。UlSearchBarStyleMinimal 风 格 没有 背景 ， 它 的 搜索 框 是 半 透 明 的 。 当 用 户 点 击 搜索 框 时 ， 男 面 会 友 生变 化 ， 搜 索 栏 会 上 移 至 导航 栏 所 在 的 区 域 ， 
如 图 9-7 右 侧 截图 所 示 。 此 时 将 出 现 用 于 显示 搜索 结果 的 表格 视图 ， 它 会 临时 替换 掉 原 来 的 表格 。 搜 索 栏 和 显示 搜索 结果 的 表格 视图 会 一 直 留 在 屏幕 上 ， 直 到 用 户 点 击 
Cancel 按 钮 为 止 ， 操 击 该 按钮 后 ， 用 户 会 重新 看 到 未 加 过 滤 的 表格 。 


9.10.1 创建 搜索 显示 控制 器 

搜索 显示 控制 器 可 以 把 另外 一 个 视图 控制 器 所 拥有 的 数据 显示 出 来 (在 本 例 中 ， 该 控制 器 是 个 标准 的 UITableViewController) 。 搜 索 显 示 控 制 器 通常 会 用 谓词 来 
过 滤 数 据 源 ， 并 把 这 份 数 据 的 某 个 子 集 显 示 到 自己 的 表格 视图 中 。 开 发 者 需要 用 搜索 栏 和 内 容 控制 器 来 初始 化 搜索 显示 控制 器 。 

我 们 可 以 像 平 党 那样 设置 搜索 栏 中 的 文本 特性 ， 但 是 不 要 设置 委托 。 因 为 搜索 栏 会 自行 与 搜索 显示 控制 器 相配 合 ， 而 无 须 开 发 者 手工 指定 其 委托 。 


配置 搜索 显示 控制 器 的 时 候 ， 请 像 下 面 这 段 代 码 一 样 设置 好 searchResults-DataSource 及 searchResultsDelegate 属 性 。 这 两 者 通常 指向 充当 主 表 格 视图 控制 器 
的 那个 UlTableViewController 子 类 ， 我们 需要 修改 类 中 现 有 的 数据 源 方法 及 委托 方法 ， 以 便 支持 搜索 功能 : 


// Create a search bar 
searchBar = [(UISearchBar alloc] 

initWithFrame:CGRectMake(0.0f, 0.0f, width, 44.0£)]; 
searchBar.autocorrectionType - UITextAutocorrectionTypeNo; 
searchBar.autocapitalizationType - UITextAutocapitalizationTypeNone; 
searchBar.keyboardType = UIKeyboardTypeAlphabet ; 
self.tableView.tableHeaderView = searchBar; 


// Create the search display controller 

searchController = [(UISearchDisplayController alloc] 
initWithSearchBar:searchBar contentsController:self]; 

searchController.searchResultsDataSource = self; 

searchController.searchResultsDelegate - self; 


9.10.2 /搜索 显示 控制 器 注册 单元 格 


程序 里 面 每 张 表格 视图 所 用 的 单元 格 类 型 都 应 该 注册 ， 这 样 系统 才能 把 它们 从 队列 中 正确 地 取出 来 。 搜 索 显 示 控 制 器 里 内 置 的 表格 所 用 的 单元 格 目 然 也 需 注册 。 
如 果 不 执行 这 一 步 融 直 接 从 self.tableView 的 队列 里 获取 单元 格 ， 那 么 程序 残 会 衣 溃 。 下 面 这 段 代 码 能 够 为 这 两 张 表格 注册 各 上 自 所 用 到 的 单元 格 类 : 


// Register cell classes 

[self.tableView registerClass: [UITableViewCell class] 
forCellReuseIdentifier:G"cell"]; 

[searchController.searchResultsTableView registerClass: [UITableViewCell class] 
forCellReuseIdentifier:G"cell"]; 


iOS 7 中 有 个 新 问题 导致 我 们 必须 改变 注册 单元 格 类 型 的 时 机 。 在 tableView: cellForRowAtIndexPath: 这 个 数据 源 方 法 中 获取 单元 格 的 时 候 ， 系 统 所 提供 的 搜 
索 表格 是 新 创建 出 来 的 ， 于 是 原来 的 注册 信息 就 丢失 了 。 要 想 解 决 这 个 问题 ， 最 简单 的 办 法 是 在 该 方法 的 开头 注册 单元 格 类 。 这 虽然 看 上 去 不 够 高 效 ， 但 在 苹果 公司 
还 没 推出 更 为 优雅 的 方法 之 前 ， 却 能 保证 对 单元 格 类 型 的 注册 操作 总 是 有 效 的 。 


阅读 本 条 解决 方案 的 代码 时 ， 你 将 看 到 在 tableView: cellForRowAtindexPath: 方法 里 ， 笔 者 会 采用 判断 语句 来 帮助 程序 把 普通 的 表格 和 显示 搜索 结果 所 用 的 表 
格 区 分 开 ， 使 该 方法 能 够 给 系统 提供 正确 的 单元 格 。 


9.10.3 ”构建 文 持 搜索 功能 的 数据 源 方法 


在 用 户 搜 索 表 格 的 过 程 中 ， 表 格 里 所 显示 的 条 目 数 量 也 会 变化 。 如 果 输 入 的 待 搜索 字符 串 比 较 短 ， 那 么 通 弟 会 匹配 到 许多 条 目 ， 各 是 比较 长 ， 则 匹配 出 来 的 条 目 
就 会 少 一 些 。 我 们 需要 向 系统 报告 每 张 表格 当前 的 行 数 。 用 户 在 搜索 框 中 输入 文本 时 ， 显 示 出 来 的 行 数 也 要 随 之 变化 。 我 们 需要 检测 传 进来 的 aTableView 参 数 ， 以 判 
断 当 前 回调 该 方法 的 控制 器 到 底 是 表格 视图 控制 器 还 是 搜索 显示 控制 器 ， 然 后 根据 情况 调整 相应 的 行 数 : 


- (NSInteger)tableView: (UITableView *)aTableView 
numberOfRowsInSection: (NSInteger)section 


if (aTableView -- searchController.searchResultsTableView) 
return [crayons filterWithString:searchBar.text]; 
return [crayons countInSection:section]; 


我 们 通过 谓词 来 报告 表格 中 有 多 少 条 目 能 和 搜索 框 里 的 文本 相 匹 配 。 谓 词 是 种 极其 简单 的 过 滤 方 式 ， 能 够 找 出 数组 中 与 某 个 待 搜索 字符 串 相 匹配 的 那些 元 素 。 本 
例 所 用 的 谓词 会 以 不 区 分 大 小 写 的 方式 来 执行 contains 匹 配 。 只 要 搜索 框 中 的 文本 包含 在 某 个 字符 串 之 中 ， 我 们 就 把 该 字符 串 留 在 过 滤 后 的 数组 里 。 此 外 ， 也 可 以 改 
用 beginswith 来 进行 匹配 ， 这 样 做 将 会 把 不 以 待 搜索 文本 开头 的 字符 串 排除 在 搜索 结果 之 外 。 下 面 这 个 方法 会 过 滤 数组 ， 保 存 搜索 结果 ， 并 返回 搜索 结果 之 中 的 条 目 
数量 : 


- (NSInteger)filterWithString: (NSString *)filter 
( 
NSPredicate *predicate = [NSPredicate predicateWithFormat: 
@"SELF contains[cd] %@", filter]; 
filteredArray - [[crayonColors allKeys] 
filteredArrayUsingPredicate:predicate]; 
return filteredArray.count; 


提供 单元 格 的 时 候 ， 一 定 要 注意 率 取 单元 格 的 到 底 是 哪 张 表格 视图 。 向 每 张 表 格 所 注册 的 单元 格 类 型 必须 正确 无 误 ; 而 从 队列 里 取出 单元 格 并 对 其 初始 化 时 ， 也 
必须 注意 该 单元 格 究竟 属于 哪 张 表 格 。 下 面 这 个 方法 会 根据 情况 ， 用 标准 的 数据 集 或 过 滤 后 的 数据 集 来 配置 单元 格 ， 并 将 其 返回 给 调用 者 : 


- (UITableViewCell *)tableView: (UITableView *)aTableView 
cellForRowAtIndexPath: (NSIndexPath *)indexPath 


[aTableView registerClass: [UITableViewCell class] 
forCellReuseIdentifier:G"cell"]; 
UITableViewCell *cell - 
(aTableView dequeueReusableCellWithIdentifier:G"cell" 
forIndexPath:indexPath]; 


NSString *crayonName; 
if (aTableView == self.tableView) 


( 
| 


else 


( 


t 


crayonName = [crayons colorNameAtIndexPath:indexPath]; 


if (indexPath.row « crayons.filteredArray.count) 
crayonName - crayons.filteredArray[indexPath.row]; 


cell.textLabel.text - crayonName; 

cell.textLabel.textColor = [crayons colorNamed:crayonName] ; 

if ({crayonName hasPrefix:@"White"] ) 
cell.textLabel.textColor = [UIColor blackColor] ; 


return cell; 


9.104 ”委托 方法 


并 不 是 只 有 数据 源 方法 才 需 要 处 理 搜索 问题 。 当 用 户 点 击 表格 的 时 候 ， 委 托 方 法 也 必须 依照 当前 的 情境 做 出 适当 的 响应 。 与 前 面 所 讲 的 数据 源 方法 一 样 ， 委 托 方 
法 同样 需要 判断 回调 时 所 传 入 的 aTableView 参 数 ， 并 以 此 来 确定 当前 处 于 活动 状态 的 是 哪 张 表格 视图 。 该 方法 会 根据 用 户 所 点 击 的 表格 及 索引 路 径 选 取 对 应 的 颜色 ， 
并 以 此 来 充当 搜索 栏 和 导航 栏 的 barTintColor: 


// Respond to user selections by updating tint colors 
- (void)tableView: (UITableView *)aTableView 
didSelectRowAtIndexPath: (NSIndexPath *)indexPath 


UIColor *color s nil; 
if (aTableView == self.tableView) 

color = [crayons colorAtIndexPath:indexPath]; 
else 


| 


if (indexPath.row « crayons.filteredArray.count) 


| 


NSString *colorName - 
crayons.filteredArray[indexPath.row]; 


if (colorName) 


color = [crayons colorNamed:colorName] ; 


self .navigationController.navigationBar.barTintColor = color; 
searchBar.barTintColor = color; 


9.10.5 ”使 用 与 搜索 功能 相配 套 的 索引 


解决 方案 9-5 演 示 了 如 何 用 其 他 一 些 方式 为 分 区 的 表格 添加 搜索 功能 。 如 果 要 支持 搜索 ， 那 么 添加 到 区 段 索引 中 的 首 个 条 目 就 应 该 是 UITableViewlndexSearch 常 
量 。 该 常量 只 应 该 用 在 表格 的 索引 中 ， 而 且 只 应 该 用 作 索 引 的 首 个 条 目 。 它 会 给 索引 里 添加 一 个 小 小 的 放大 镜 图 标 ， 告 诉 用 户 可 以 搜索 这 张 表 格 。 我 们 需要 编写 代 
码 ， 使 得 用 户 能 够 通过 点 击 该 图 标 来 快速 跳 转 到 列表 顶部 。 修 改 tableView: sectionForSectionIndexTitle: atindex: 方法 ， 以 捕获 用 户 的 请 求 。 在 用 户 点 击 放 大 镜 
图 标的 时 候 ， 我 们 会 在 该 方法 里 手动 调用 scrollRectToVisible: animated: 方法 ， 以 便 把 搜索 栏 显 示 到 屏幕 范围 内 。 如 果 不 这 样 做 ， 那 么 用 户 就 必须 从 0 号 区 段 向 上 滚 
动 才能 看 到 搜索 栏 ，0 号 区 段 里 的 单元 格 都 以 字母 A 开 头 。 


解决 方案 9-5 “使 用 搜索 功能 


// Add Search to the index 
- (NSArray *)sectionIndexTitlesForTableView: 
(UITableView *)aTableView 


if (aTableView == searchController.searchResultsTableView) 
return nil; 


// Initialize with the search magnifying glass 
NSMutableArray *indices - [NSMutableArray 
arrayWithObject :UITableViewIndexSearch] ; 


for (int i = 0; i « crayons.numberOfSections; i++) 
NSString *name = [crayons nameForSection:i] ; 
if (name) [indices addObject:name] ; 


return indices; 


// Handle both the search index item and normal sections 

- (NSInteger)tableView: (UITableView *)tableView 
sectionForSectionIndexTitle: (NSString *)title 
atIndex: (NSInteger) index 


if (title -- UITableViewIndexSearch) 


| 


[self.tableView scrollRectToVisible:searchBar.frame 
animated:NO]; 
return -1; 


} 


return [ALPHA rangeOfString:title].location; 


| 


// Handle the Cancel button by resetting the search text 
- (void)searchBarCancelButtonClicked: (UISearchBar *)aSearchBar 


| 


[searchBar setText:@""]; 


// Titles only for the main table 
- (NSString *)tableView: (UITableView *) aTableView 
titleForHeaderInSection: (NSInteger)section 


if (aTableView -- searchController.searchResultsTableView) 
return nil; 
return [crayons nameForSection:section]; 


// Upon appearing, scroll away the search bar 
- (void)viewDidAppear: (BOOL)animated 


| 


[super viewDidAppear:animated]; 

NSIndexPath *path - 
[NSIndexPath indexPathForRow:0 inSection:0]; 

[self.tableView scrollToRowAtIndexPath:path 
atScrollPosition:UITableViewScrollPositionTop 
animated:NO]; 


我 们 在 viewWillAppear: 方法 里 面 调用 scrollToRowAtlndexPath ， 使 得 视图 刚刚 加 载 进来 的 时 候 搜 索 栏 会 位 于 屏幕 范围 乙 外 。 这 样 的 话 ， 一 开始 融 不 会 看 到 表格 
的 搜索 栏 了 ， 用 户 可 以 向 下 滚动 表格 ,把 搜索 栏 显示 出 来 ， 也 可 以 跳 转 到 自己 想 看 的 其 他 地 方 。 


最 后 ， 如 果 用 户 要 取消 搜索 操作 ， 我 们 融 提 前 把 搜索 栏 里 的 文本 清空 。 


9.11 解决 方案 : 给 表格 添加 下 拉 刷 新 功能 


下 拉 刷 新 是 个 使 用 面 很 广 的 程序 特性 ， 在 过 去 几 年 的 App Store 里 非常 流行 。 用 户 可 以 向 下 拉 搜 表格 的 顶端 ， 从 而 请 求 程 序 刷新 表格 内 容 。 由 于 这 种 操作 方式 相当 
直观 ， 所 以 很 多 人 都 在 考虑 苹果 公司 为 什么 还 不 把 它 添加 到 UITableViewController 类 里 。 在 iOS 6 中 ， 芋 果 公司 创建 了 一 种 极 具 特色 的 刷新 控件 ， 它 可 以 拉 伸 ， 而 且 
具备 动画 效果 。 到 了 iOS 7， 这 个 可 拉 伸 的 控件 换 成 了 更 为 传统 的 活动 指示 器 (activity indicator) ， 而 且 指示 器 稍稍 多 了 一 些 动画 效果 ， 以 便 把 控件 的 状态 反馈 给 用 
P (参见 图 9-8) , 
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图 9-8 ”开发 者 很 容易 就 能 给 表格 添加 下 拉 刷 新 功能 。 用 户 通过 向 下 拉 搜 表格 来 请 求 程 序 更 新 其 中 的 数据 


新 的 UIRefreshControl 类 是 一 种 非常 方便 的 控件 ， 可 以 用 它 来 表示 表格 的 刷新 功能 。 解 决 方案 9-6 演 示 了 怎样 将 其 添加 到 应 用 程序 里 。 开 发 者 只 需 新 建 
UIRefreshControl 实 例 ， 并 将 其 赋 给 表格 视图 控制 器 的 refreshControl 属 性 ， 即 可 使 控件 直接 出 现在 表格 视图 中 ， 而 无 须 再 执行 其 他 操作 。 当 用 户 向 下 拉 搜 表格 视图 
的 时 候 ， 就 能 显示 并 触发 UlRefreshControl 控 件 了 。 


若 想 以 编程 的 方式 激活 刷新 控件 ， 则 需要 用 begin Refreshing 来 触发 刷新 事件 ， 此 时 控件 会 变 成 带 有 动画 效果 的 进度 转 轮 。 准 备 好 新 数据 之 后 ， 用 
endRefreshing 结 束 刷 新 过 程 ， 并 重新 加 载 表 格 视图 。 


由 于 该 控件 是 从 UIControl 类 继承 下 来 的 ， 所 以 该 控件 的 实例 在 激活 的 时 候 也 采用 目标 -动作 机 制 来 向 客户 端 友 送 定 制 的 选择 子 。 由 于 某 些 原因 ， 在 程序 应 该 执行 
刷新 操作 时 ， 此 控件 触 皮 的 是 UIControlEventValueChanged 事 件 。 其 实 对 于 这 种 无 状态 (stateless) 的 控件 来 说， 苹果 公司 早 融 应 该 引入 一 种 
UIControlEventTriggered 事 件 了 。 


采用 下 拉 刷 新 控件 可 以 使 程序 暂缓 执行 某 些 开销 比较 大 的 任务 。 比 方 说 ， 我 们 可 以 暂时 不 从 互联 网 上 获取 新 的 信息 ， 或 是 暂时 不 重新 计算 表格 中 的 元 素 ， 直 到 用 
户 明 确 触 友 这 些 请 求 的 时 候 我 们 再 去 做 。 通 过 下 拉 刷 新 控件 ， 用 户 可 以 控制 刷新 的 时 机 ， 而 程序 也 可 以 在 按照 客 尸 的 需求 获取 信息 和 减少 计算 开销 之 间 取 得 平衡 。 


解决 方案 9-6 中 的 DataManager 类 会 通过 操作 队列 (operation queue) 以 异步 的 方式 加 载 数据 : 


- (void) loadData 
| 
NSString *rss = @"http://itunes.apple.com/us/rss/topalbums/limit=30/xml"; 
NSOperationQueue *queue - [[NSOperationQueue alloc] init]; 
[queue addOperationWithBlock: 
本 
root = [[XMLParser sharedInstance] parseXMLFromURL: 
[NSURL URLWithString:rss]]; 
[[NSOperationQueue currentQueue] addOperationWithBlock: “{ 
[self handleDatal; 
BE 
Hl; 


这 样 做 可 以 避免 数据 加 载 操 作 阻 塞 到 主线 程 。 刷 新 控件 的 进度 转 轮 依然 会 旋转 ， 而 用 户 也 可 以 继续 操作 程序 里 的 其 他 UI 元 件 。 执 行 完 数据 获取 操作 之 后 ， 我 们 把 
控制 权 还 给 主线 程 : 


if (delegate && 
[delegate respondsToSelector:@selector (dataIsReady: ) ] ) 
[delegate performSelectorOnMainThread: @selector (dataIsReady:) 
withObject:self waitUntilDone:NO]; 


解决 方案 9-6 除 了 有 刷新 控件 之 外 ， 还 提供 了 Load 按 钮 。 大 部 分 程序 都 不 会 同时 提供 这 两 种 刷新 手段 ， 不 过 解决 方案 9-6 想 通过 这 个 按钮 来 演示 它 如 何 与 刷新 控件 
之 间 互 动 。 当 用 户 点 击 Load 按 钮 之 后 ， 开 发 者 仍然 需要 执行 UIRefreshControl 的 startRefreshing 及 endRefreshing 方 法 。 这 样 做 可 以 确保 UIRefreshControl 与 通过 点 
击 Load 按 钮 而 触发 的 手工 刷新 操作 之 间 能 够 同步 。 


解决 方案 9-6 ”给 表格 添加 下 拉 刷 新 功能 


- (void) dataIsReady: (id) sender 


| 


// Update the title 
self.title = G"iTunes Top Albums"; 


// Reenable the bar button item 
self.navigationItem.rightBarButtonItem.enabled - YES; 


// Stop refresh control animation and update the table 
[self.refreshControl endRefreshing]; 
[self.tableView reloadData]; 


- (void) loadData 

{ 
// Provide user status update 
self.title = @"Loading..."; 


// Disable the bar button item 
self .navigationItem.rightBarButtonItem.enabled = NO; 


// Start refreshing 
[self.refreshControl beginRefreshing] ; 


[manager loadData]; 


- (void) viewDidLoad 
{ 
[super viewDidLoad] ; 
self.tableView.rowHeight = 72.0f; 
[self.tableView registerClass: [UITableViewCell class] 
forCellReuseldentifier:@"generic"] ; 


// Offer a bar button item and... 
self .navigationItem.rightBarButtonItem = 
BARBUTTON (@"Load", @selector(loadData) ) ; 


// Alternatively, use the refresh control 

self.refreshControl = [[UIRefreshControl alloc] init]; 

[self.refreshControl addTarget:self action:@selector (loadData) 
forControlEvents:UIControlEventValueChanged] ; 


// This custom data manager asynchronously (nonblocking) loads 
// data in a secondary thread 

manager = [[DataManager alloc] init]; 

manager.delegate = self; 


9.12 fEAJS3&: 添加 指令 行 


如 果 某 个 单元 格 与 指令 行 (action row， 也 叫 作 drawer cell ( 抽 居 式 单元 格 ) ) 相关 联 ， 那 么 当 用 户 点 击 该 单元 格 时 ， 将 会 弹出 与 之 有 关 的 一 些 附加 操作 。 在 
Tweetbot (http://tapbots.com) 等 商业 程序 中 可 能 会 看 到 这 种 功能 。 解 决 方案 9-7 所 构建 的 指令 行 里 面 有 两 个 “ 抽 展 ”， 每 个 “ 抽 懂 ”里 面 各 有 一 枚 按钮 (参见 图 
9-9) 。 用 户 点 击 Title 按 钮 之 后 ， 程 序 会 把 单元 格 里 的 文本 设 为 导航 栏 的 标题 ， 如 果 用 户 点 击 Alert 按 钮 ， 那 么 屏幕 上 就 会 弹出 警告 界面 ， 界 面 里 的 字符 串 与 单元 格 的 文 


本 相同 。iOs 开 上 者 Bilal Sayed Ahmad (TwitterS#42@Demonic BLITZ) 建议 笔者 把 这 个 功能 添加 到 本 书 之 中 ， 这 条 解决 方案 的 代码 借鉴 了 由 他 所 创建 的 范例 项 
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图 9-9 ”指令 行 里 面 提供 了 一 些 与 单元 格 相关 的 指令 ， 当 用 户 点 击 单元 格 时 ， 指 令 行 就 会 弹出 来 。 在 本 例 中 ， 用 户 点 击 了 Romeo 按 钮 ， 于 是 两 个 隐藏 的 抽 层 式 按钮 就 会 


弹出 来 ， 它 们 是 Title 按 钮 和 Alert 按 钮 


解决 方案 9-7 会 把 一 个 隐藏 的 单元 格 添加 到 表格 视图 中 ， 其 他 的 单元 格 都 会 根据 该 单元 格 是 否 展 示 出 来 而 做 出 调整 。 首先 要 调整 的 是 汇报 每 个 区 段 内 单元 格 数 量 的 


方法 ,指令 行 的 索引 路 径 存 放 在 actionRowPath 中 。 如 果 我 们 已 经 把 这 个 隐藏 的 单元 格 显示 出 来 了 ， 那 么 表格 中 的 单元 格 数量 就 会 比 原来 多 1。 如 果 它 是 隐藏 着 的 ， 那 
么 数据 源 方法 束 返 回 平 弟 的 单元 格 数量 。 


解决 方案 9-7 ”向 表格 中 添加 指令 行 
// Rows per section 
- (NSInteger)tableView: (UITableView *)aTableView 


numberOfRowsInSection: (NSInteger) section 


return items.count + (self.actionRowPath != nil); 


// Return a cell for the index path 
- (UITableViewCell *)tableView: (UITableView *)aTableView 
cellForRowAtIndexPath: (NSIndexPath *)indexPath 


if ([self.actionRowPath isEqual:indexPath] ) 
{ 
// Action Row 
CustomCell *cell = (CustomCell *) [self.tableView 
dequeueReusableCellWithIdentifier:@"action" 
forIndexPath:indexPath] ; 
[cell setActionTarget:self]; 
return cell; 


} 


else 
{ 
// Normal cell 
UITableViewCell *cell = [self.tableView 
dequeueReusableCellWithIdentifier:G"cell" 
forIndexPath: indexPath]; 
// Adjust item lookup around action row if needed 
NSInteger adjustedRow = indexPath.row; 
if (_actionRowPath && 
( actionRowPath.row < indexPath.row)) 
adjustedRow--; 
cell.textLabel.text - items[adjustedRow]; 


cell.textLabel.textColor - [UIColor blackColor]; 
cell.selectionStyle - UITableViewCellSelectionStyleGray; 
return cell; 


- (NSIndexPath *)tableView: (UITableView *)tableView 
willSelectRowAtIndexPath: (NSIndexPath *)indexPath 


// Only select normal cells 
if([indexPath isEqual:self.actionRowPath]) return nil; 
return indexPath; 


// Deselect any current selection 
- (void)deselect 


{ 


NSArray *paths = [self.tableView indexPathsForSelectedRows] ; 
if (!paths.count) return; 


NSIndexPath *path = paths[0]; 


[self.tableView deselectRowAtIndexPath:path animated: YES] ; 


// On selection, update the title and enable find/deselect 


- (void)tableView: (UITableView *)aTableView 
didSelectRowAtIndexPath: (NSIndexPath *) indexPath 


NSArray *pathsToAdd; 
NSArray *pathsToDelete; 


if ([self.actionRowPath.previous isEqual:indexPath] ) 


| 


// Hide action cell 


pathsToDelete = @[self.actionRowPath] ; 
self.actionRowPath = nil; 
[self deselect] ; 


| 


else if (self.actionRowPath) 


{ 


// Move action cell 

BOOL before = [indexPath before:self.actionRowPath] ; 
pathsToDelete = @[self.actionRowPath] ; 

self.actionRowPath = before ? indexPath.next : indexPath; 
pathsToAdd = @[self.actionRowPath] ; 


| 


else 
// New action cell 
pathsToAdd = @[indexPath.next] ; 
self.actionRowPath - indexPath.next; 


// Animate the deletions and insertions 
[self.tableView beginUpdates]; 
if (pathsToDelete.count) 
[self.tableView deleteRowsAtIndexPaths:pathsToDelete 
withRowAnimation:UITableViewRowAnimationNone] ; 
if (pathsToAdd.count) 
[self.tableView insertRowsAtIndexPaths:pathsToAdd 
withRowAnimation:UITableViewRowAnimationNone]; 
[self.tableView endUpdates]; 


// Set up table 
- (void)viewDidLoad 
{ 
[super viewDidLoad] ; 
self.tableView.rowHeight = 60.0f; 
self.tableView.backgroundColor = 
[UIColor colorWithWhite:0.75f alpha:1.0£]; 


[self.tableView registerClass: [UITableViewCell class] 
forCellReuseIdentifier:G"cell"]; 
[self.tableView registerClass:[CustomCell class] 


forCellReuseIdentifier:G"action"]; 

items = [@"Alpha Bravo Charlie Delta Echo Foxtrot Golf V 
Hotel India Juliet Kilo Lima Mike November Oscar Papa \ 
Quebec Romeo Sierra Tango Uniform Victor Whiskey Xray ^ 
Yankee Zulu" componentsSeparatedByString:@" "]; 


viewDidLoad 方 法 注册 了 两 种 单元 格 类 型 ， 一 种 是 表格 中 的 普通 行 ， 另 一 种 是 指令 行 。 如 果 系 统 向 数据 源 方法 索取 的 单元 格 是 CustomCell 类 型 的 ， 那 么 该 方法 就 


会 返回 适当 的 指令 行 。 


虽 令 单元 格 (action cell) 还 有 其 他 一 些 比较 麻烦 的 地 方 。 例 如 ， 用 尸 是 不 能 选中 这 种 单元 格 的 。 为 了 确保 这 一 点 ， 解 决 方案 9-7 的 tableView: 
willSelectRowAtindexPath: 方法 若 友 现 传 入 的 索引 路 径 表 示 指 令 行 ， 则 会 返回 nil。 


这 条 解决 方案 的 重要 实现 代码 基本 上 都 写 在 tableView: didSelectRowAtindex-Path: 方法 里 。 该 方法 会 修改 指令 行 的 路 径 ， 并 更 新 表格 中 的 单元 格 ， 以 便 把 指 
令 抽 居 移 动 到 适当 的 位 置 上 。 我 们 要 考虑 三 种 情况 : 用 户 在 指令 行 没 有 显示 出 来 的 时 候 点 击 了 新 的 单元 格 ;， 用 户 在 指令 行 显示 出 来 之 后 叉 点 击 了 原来 那个 单元 格 ; 用 
尸 在 指令 行 显示 出 来 之 后 点 击 了 其 他 单元 格 。 


当 指 令 抽 居 收 起 来 的 时 候 ， 指 令 行 的 索引 路 径 总 是 nil。 如 果 用 户 点 击 了 某 个 单元 格 ， 那 么 tableView: didSelectRowAtIndexPath: 方法 就 把 据 令 行 的 路 径 设置 
到 单元 格 下 方 。 如 果 用 户 在 指令 行 显示 出 来 的 时 候 又 点 击 了 它 上 方 的 那个 相关 单元 格 ， 那 么 指令 抽 展 就 会 “关上 ”， 而 它 的 索引 路 径 也 会 设 为 nil。 如 果 用 户 点 击 的 不 
是 原来 那个 单元 格 ， 那 么 该 方法 束 会 执行 一 些 运 算 ， 根据 新 单元 格 是 位 于 原 有 指令 行 的 下 方 还 是 上 方 来 做 出 相应 的 调整 。 


我 们 把 与 表格 有 关 的 操作 都 放 在 配套 的 beginUpdates 方 法 与 endUpdates 方 法 之 间 ， 以 便 能 够 同时 展示 其 动画 效果 。 在 移动 、 添 加 及 移 除 指令 行 时 ， 表 格 的 内 容 
要 发 生变 化 ， 而 把 这 些 变化 放 在 beginUpdates 与 endUpdates 之 间 执 行 ， 则 可 令 这 个 过 程 更 加 平滑 。 


9.13 ”制作 自 定义 的 分 组 表格 


在 iPhone 的 表格 中 ， 如 果 把 依照 首 字母 来 分 区 的 表格 看 成 M.C.Escherl 1 的 画作 ， 那 么 自由 形式 的 分 组 表格 就 相当 于 Marc Chagalll 和 的 作品 。 前 者 的 每 个 区 段 都 精 
确 地 排 布 在 表格 中 ， 而 后 者 的 每 个 部 分 都 可 以 自由 定制 ， 它 是 一 件 手绘 的 艺术 品 。 


对 于 本 章 前 面 讲 过 的 那些 表格 来 说 ， 只 要 掌握 了 诀 穷 ， 融 不 难 用 代码 把 它们 全 都 编写 出 来 。 但 奋 想 用 代码 编 出 一 张 精 巧 的 分 组 表格 ， 可 融 相 当 不 容易 了 (因为 系 
统 的 Settings 程 序 里 面 用 到 了 这 种 表格 ， 所 以 分 组 表格 的 爱好 者 把 它 叫 作 (偏好 设置 表格 ) 。 


用 代码 来 构建 分 组 表格 相当 于 拼 贴 (collage) ， 我 们 要 一 块 一 块 地 把 这 张 表 格 拼 出 来 。 以 编程 的 方式 创建 这 样 的 表格 需要 处 理 很 多 细节 问题 。 


创建 分 组 式 的 偏好 设置 表格 


在 制作 偏好 设置 表格 的 过 程 中 ， 新 建 并 排 布 UITableViewController 的 操作 并 没有 特别 之 处 ， 依 然 需要 先 分 配 内 存 ， 然 后 用 表格 样式 来 初始 化 它 。 基 本 上 就 是 这 些 
了 。 困 难 的 地 方 在 于 如 何 实现 数据 源 方法 与 委托 方法 。 下 面 列 出 开发 者 需要 定义 的 方法 : 


: numberOfSectionsInTableView: 一 一 每 一 张 偏好 设置 表格 都 含有 一 定数 量 的 分 组 。 每 个 分 组 的 背景 都 是 白色 的 ， 这 与 整 张 表格 的 灰色 背景 形成 了 对 比 。 该 方 


法 返回 表格 中 的 分 组 数量 ， 这 个 值 是 个 整数 。 


. tableView: titleForHeaderlnSection: 这 个 可 选 方法 应 该 返回 每 个 区 段 的 标题 。 当 程序 询问 某 个 区 段 的 名 称 时 ， 返 回 相 应 的 NSString。 


. tableView: numberOfRowslnSection: 该 方法 返回 每 个 区 段 所 包含 的 单元 格 数量 。 程 序 询问 某 个 分 组 所 包含 的 行 数 (也 就 是 单元 格 数量 ) 时 ， 该 方法 应 


该 返回 整数 值 。 


- tableView: heightForRowAtlndexPath : 如 果 表 格 的 行 高 是 可 以 变化 的 ， 那 么 程序 所 要 执行 的 运算 量 就 会 更 大 一 些 。 若 想 使 用 可 变 的 行 高 ， 那 么 就 实现 


这 个 可 选 的 方法 ， 并 返回 菜 行 的 高 度 。 我 们 需要 依照 程序 所 询问 的 区 段 及 行 来 返回 适当 的 值 。 


: tableView: cellForRowAtindexPath: 一 一 本 章 多 次 用 到 了 这 个 标准 的 方法 ， 它 负责 提供 与 某 一 行 相 对 应 的 单元 格 。 对 于 偏好 设置 表格 来 说 ， 它 的 实现 方式 与 
普通 的 表格 不 同 。 首 通 的 表格 通常 只 使 用 一 种 单元 格 ， 但 偏好 设置 表格 可 能 会 创建 出 很 多 种 可 供 复 用 的 单元 格 ， 每 种 单元 格 都 对 应 于 一 种 单元 格 类 型 (而 且 有 它 自己 
的 复 用 标记 (reuse tag) ) 。 开 发 者 应 该 仔细 管理 好 复 用 队列 ， 并 且 尽 量 使 用 与 IJB 相 集成 的 UI 元 件 。 


- tableView: didselectRowAtlndexPath : 一 一 开发 者 需要 根据 用 户 所 选单 元 格 的 类 型 ， 在 这 个 可 选 的 委托 方法 中 根据 情况 做 出 响应 。 


Qian Google Code Ł dg 4j 4- 7F 78 55 A” 4Ellamasettings (http://llamasettings.googlecode.com/) ， 它 能 够 根据 iPhone 程序 settings bundle 中 的 属性 列表 自动 生成 分 组 
表格 。 这 样 就 能 把 这 些 设置 选项 直接 集成 到 应 用 程序 里 面 ， 使 得 用 户 无 须 离开 程序 ， 即 可 调整 其 设置 。 开 发 者 可 把 该 项 目 添加 到 用 iOS SDK 所 开发 的 商业 程序 中 ， 而 无 
须 支付 授权 费 。 


[1] 3X 3€ - 科 内 利 斯 埃 合 尔 (IMaurits Cornelis Escher, 1898-1972) ， 和 荷兰 版 画家 ， 因 绘画 中 的 数学 性 而 闻名 。 译 者 注 


[2] 马克 夏 卡 尔 (1887-1985) ， 超 现实 主义 画家 。 译 者 注 


9.14 解决 万 案 : 构建 舍 有 多 个 浚 轮 的 表格 


有 时 用 户 需要 从 一 份 很 长 的 列表 中 选择 某 个 条 目 ， 或 是 需要 同时 从 多 份 列 表 中 分 别 做 出 选择 。UIPickerView 实 例 很 适合 用 在 这 些 情况 下 。UIPickerView 对 象 制作 
出 的 表格 提供 了 很 多 各 自 独 立 的 滚轮 ， 如 图 9-10 所 示 。 用 户 可 以 通过 操作 这 些 滚轮 来 做 出 选择 。 


Carrier = 


S*H*D 


KJ9-10 ”UIPickerView 实 例 使 得 用 户 能 够 操作 多 个 独立 的 滚轮 ， 以 做 出 自己 的 选择 


这 些 表格 从 表面 上 看 与 标准 的 UITableView 实 例 相似 ， 但 它们 却 使 用 独特 的 数据 源 协 议和 委托 协议 : 


- 没有 UIPickerViewController 类 。UIPicker-View 实 例 扮 演 其 他 视图 的 子 视图 。 在 应 用 程序 里 ， 它 们 并 不 打算 成 为 视图 的 中 心 焦 点 。 开 发 者 可 以 把 UIPickerView 实 
例 放 在 另 一 个 视图 里 面 。 


- UIPickerView 采 用 数字 而 非 对 象 来 表示 其 中 的 滚轮 。UIPickerView 里 的 组 件 (也 就 是 滚轮 ) 是 用 数字 来 编号 的 ， 而 不 与 NSIndexPath 实 例 相 对 应 。 这 个 类 不 像 
UITableView 那 样 严整 。 


在 实现 数据 源 协议 时 ， 开 发 者 既 可 以 提供 字符 串 ， 也 可 以 提供 视图 。 这 两 种 方式 UlPickerView 都 能 处 理 。 


9.14.1 创建 UlPickerView 


创建 选取 器 的 时 候 ， 别 志 了 设置 delegate 与 dataSource。 如 果 不 这 样 做 ， 那 么 束 无 法 向 视图 里 添加 数据 、 无 法 定义 其 特性 ， 也 无 法 响应 用 户 所 做 的 选择 。 主 视图 
控制 器 应 该 实现 UlPickerViewDelegate 与 UlPickerViewDataSource 协 议 。 


9.14.2 ”数据 源 方 法 与 委托 方法 


为 了 使 UlPickerView 具 备 最 基本 的 功能 ,我 们 需要 实现 下 面 这 三 个 关键 的 数据 源 方法 。 它 们 分 别 是 : 


- numberOfComponentsInPickerView: 该 方法 返回 视图 里 的 列 数 ， 其 返回 值 是 个 整数 。 


- pickerView: numberOfRowslnComponent: 该 方法 返回 每 个 滚轮 所 具备 的 行 数 ， 其 返回 值 是 个 整数 。 滚 轮 的 行 数 不 一 定 都 要 相同 。 其 中 一 个 滚轮 可 以 


有 很 多 行 ， 而 另外 一 个 滚轮 则 可 以 只 有 几 行 。 


- pickerView: titleForRow: forComponent: 或 pickerView: viewForRow: forComponent: reusingView: 这 两 个 方法 可 以 为 滚轮 中 的 某 一 行 指定 文 


本 或 视图 ， 以 便 用 作 该 行 的 标签 。 


除了 这 些 数 据 源 方法 之 外 ， 还 可 以 再 实现 一 个 委托 方法 ， 访 方法 能 够 响应 用 户 对 某 个 滚轮 的 选取 操作 : 


: pickerView: didSelectRow: inComponent: 可 以 在 该 方法 内 实现 与 应 用 程序 有 关 的 行为 。 如 果 有 必要 ， 可 以 在 pickerView 上 面 调 用 selectedRow- 


InComponent: 方法 来 查询 用 户 在 某 个 滚轮 中 选 定 了 哪 一 行 。 


9.14.3 ”使 用 市 有 选取 器 的 钢 图 


选取 器 视图 采用 了 一 套 简 单 的 视图 复 用 方式 ， 它 会 把 提供 给 自己 的 视图 缓存 起 来 ， 以 便 稍 后 重新 使 用 。 如 果 pickerView: viewForRow: forComponent: 
reusingView: 方法 的 最 后 一 个 参数 不 是 nil， 那 么 开发 者 可 以 重新 使 用 经 由 该 参数 所 传 入 的 视图 ， 并 更 新 其 设置 或 内 容 。 我 们 应 该 检查 这 个 参数 ， 只 在 程 序 没 有 提供 
所 需 的 视图 时 才 去 新 建 它 。 


深 轮 每 一 行 的 高 度 不 一 定 要 与 实际 的 视图 相符 。 我 们 可 以 实现 pickerView: rowHeight-ForComponent: 方法 ， 并 企 其 中 指定 每 个 滚轮 每 一 行 的 高 度 。 解 决 方案 
9-8 把 行 高 设 为 120 个 点 ， 这 样 就 有 足够 的 空间 来 显示 图 像 了 ， 而 且 还 可 以 造成 一 种 滚轮 可 以 无 限 循 环 滚动 的 假象 ， 令 用 户 察觉 不 到 它 的 起 点 和 终点 。 


解决 方案 9-8 ”模拟 可 以 反复 滚动 的 圆柱 形 滚轮 


(NSInteger)numberOfComponentsInPickerView: 
(UIPickerView *)pickerView 


return 3; // three columns 
- (NSInteger)pickerView: (UIPickerView *)pickerView 
numberOfRowsInComponent : (NSInteger)component 


return 1000000; // arbitrary and large 


(CGFloat)pickerView: (UIPickerView *)pickerView 
rowHeightForComponent: (NSInteger) component 


return 120.0f; 


- (UIView *)pickerView: (UIPickerView *)pickerView 
viewForRow: (NSInteger)row forComponent: (NSInteger) component 
reusingView: (UIView *)view 


// Load up the appropriate row image 
NSArray *names = @[@"club", @"diamond", @"heart", @"spade"] ; 
UlImage *image = [UIImage imageNamed:names [row%4] ] ; 


// Create an image view if one was not supplied 
UIImageView *imageView = (UIImageView *) view; 
imageView.image = image; 
if (!imageView) 

imageView = [[UIImageView alloc] initWithImage:image] ; 


return imageView; 


- (void) pickerView: (UIPickerView *)pickerView 


didSelectRow: (NSInteger)row inComponent: (NSInteger)component 


// Respond to selection by setting the view controller's title 


NSArray *names = @[@"C", @"D", @"H", Q"S"]; 

self.title = [NSString stringWithFormat :@"%@e%@e%@" , 
names [[pickerView selectedRowInComponent : 0] 
names [[pickerView selectedRowInComponent :1] 


oo ov ov 


names[[pickerView selectedRowInComponent :2] 


- (void)viewDidAppear: (BOOL)animated 


| 


[super viewDidAppear:animated] ; 


// Set random selections as the view appears 


[picker selectRow:50000 + (rand() % 4) 
[picker selectRow:50000 + (rand() % 4) 


[picker selectRow:50000 + (rand() 4) 


- (void) loadView 


| 


self.view - [[UIView alloc] initl; 


inComponent:0 animated:YES]; 
inComponent:1 animated:YES]; 
inComponent:2 animated:YES]; 


self.view.backgroundColor = [UIColor whiteColor]; 


// Create the picker and center it 


picker - [[UIPickerView alloc] initWithFrame:CGRectZero]; 


[self.view addSubview:picker]; 
PREPCONSTRAINTS (picker); 
CENTER VIEW H(self.view, picker); 
CENTER VIEW V(self.view, picker); 


// Initialize the picker properties 
picker.delegate = self; 
picker.dataSource = self; 
picker.showsSelectionIndicator = YES; 


请 注意 ， 我 们 把 每 个 滚轮 的 总 行 数 定 为 一 百 万 。 之 所 以 要 用 这 么 大 的 值 ， 就 是 为 了 模拟 出 真实 的 圆柱 形 滚轮 ( 简 状 滚轮 ) 。 一 般 来 说，UIPickerView 里 面 的 滚轮 
都 有 起 始 元 素 和 终止 元 素 ， 滚 轮 到 了 最 后 一 个 元 素 之 后 ， 就 不 能 再 继续 滚动 了 。 于 是 ， 我 们 会 想 : 如 果 程 序 里 的 滚轮 和 真实 的 圆柱 形 滚轮 一 样 ， 那 么 在 到 达 了 最 后 一 
项 之 后 ， 接 下 来 应 该 又 出 现 第 一 项 才 对 。 为 了 模拟 这 种 效果 ， 本 条 解决 方案 把 滚轮 的 行 数 设 置 成 了 一 个 非常 大 的 值 ， 使 得 用 户 不 太 可 能 卷 动 到 滚轮 的 末端 。 它 调用 
selectRow: inComponent: Animated: 方法 ， 把 滚轮 的 初始 位 置 设 为 这 个 大 值 的 一 半 。 我 们 把 用 户 当 前 浴 动 到 的 行 数 与 滚轮 中 的 图 像 种 数 相 除 ， 并 根据 余数 来 决 
定 这 一 行 应 该 显示 哪 幅 图 像 (具体 到 本 例 来 说 ， 就 是 ow%4) 。 虽 说 程序 代码 把 每 个 滚轮 的 总 行 数 设 成 了 一 百 万 ， 但 用 户 却 会 以 为 这 是 个 圆柱 形 滚轮 ， 它 里 面 只 有 四 


/一 


{To 


Qu ARHHIOSR AY, 4 RAP REALE P HB HEUIPickerView d IUBE, ARLILAUPickerViewis KAHLER 一 个 视图 中 。 比 方 说 ， 用 户 在 点 击 
了 某 个 日 期 字段 之 后 ， 程 序 会 展示 一 个 新 的 视图 ， 并 把 选取 日 期 所 用 的 UIPicketView 显 示 在 那个 视图 里 面 。 在 iDOS 7 中 ， 蔷 果 公 司 已 经 开始 把 UIPicketView 直 接 上 时 入 到 应 


用 程序 的 内 容 中 了 。 革 果 公 司 的 《Human Interface Guidelines? (人 机 界面 指南 ，HIG) 里 面 说 ， 应 该 把 UIPickerView 府 在 内 容 之 中 ,无须 令 用 户 跳 转 到 另外 一 个 视图 。 


我 们 在 iOS 7 的 Calendat 程 序 中 就 可 以 看 到 这 种 用 法 。 


9.15 ”使 用 UlDatePicker 


有 了 时 可 能 需要 请 用 户 输 入 日 期 信息 。 苹 果 公 司 提供 了 非常 好 的 UlPickerView 子 类 ， 用 于 处 理 几 种 日 期 与 时 间 的 输入 。 图 9-11 演 示 了 四 种 内 置 的 UIDatePicker 样 


式 ， 它 们 分 别 用 来 选择 时 间 、 选 择 日 期 、 选 择 日 期 与 时 间 以 及 设 定 倒数 计时 。 
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图 9-11 iPhone 提供 了 四 种 内 置 的 数据 选取 器 模型 。 开 发 者 可 以 通过 datePicketMode 属 性 来 设 定 程序 所 需 的 选取 器 


创建 UIDatePicker 


UlDatePicker 的 创建 过 程 与 UIPickerView 的 相同 ， 两 者 的 布局 方式 也 一 样 。 创 建 好 UIDatePicker 对 象 之 后 ， 就 简单 多 了 。 我 们 不 需要 设置 委托 ， 也 不 需要 定义 数 
据 源 方法 ， 而 且 还 不 用 声明 任何 协议 ， 只 需要 为 UIDatePicker 指 定 一 种 模式 就 好 。 可 供 选 择 的 模式 有 UlDatePickerModeTime、UlDatePickerModeDate、 
UIDatePickerModeDateAndTime2 UIDatePickerModeCountDownTimer: 


[datePicker setDate: [NSDate date]}; // set date 
datePicker.datePickerMode = UIDatePickerModeDateAndTime; // set style 


开发 者 可 以 添加 目标 ， 以 便 侦 测 用 户 通 过 UIDatePicker 所 做 的 修改 (此 时 会 发 生 UIControlEventValueChanged 事 件 ) ， 同 时 需要 创建 目标 -动作 组 合 所 使 用 的 回 
调 方法 。 
使 用 UIDatePicker 类 的 时 候 ， 可 能 需要 操控 下 面 几 个 属性 : 


- gate 一 一 初始 化 UIDatePicketr 的 时 候 ， 可 以 通过 该 属性 来 设 定 初 始 的 上 日期) 用户 通过 滚轮 操作 UIDatePicket 之 后， 开发 者 可 以 通过 该 属性 获取 用 户 所 选 定 的 日 


期 。 


- maximumDate 和 minimumDat fit i 


间 范 围 。 我 们 应 该 个 属性 赋予 标准 的 NSDate 值 。 借 助 这 一 手段 ， 开 发 
者 可 以 令 用 户 只 能 选择 一 年 之 后 的 某 个 日 期 ， 而 不 是 先 等 用 户 选 择 完 了 ， 然 后 再 去 判断 所 选 日 期 是 否 处 在 可 以 接受 的 范围 内 。 


- minutelnterval 一 一 有 时 我 们 想 令 用 户 在 选择 时 间 的 时 候 ， 必 须 以 5 分 钟 、10 分 钟 、15 分 钟 或 30 分 钟 为 间隔 进行 选择 ， 比 方 说 安排 约会 事项 所 用 的 应 用 程序 可 能 
就 需要 这 样 做 。minutelInterval 属 性 用 来 指定 这 个 间隔 值 。 开 发 者 所 传 入 的 值 必 须 能 为 60 所 整除 。 


- countDownDuration 


该 属性 用 来 设置 用 户 能 够 在 倒数 计时 器 里 选择 的 最 大 值 。countDownDuration 最 多 可 以 达到 23 小 时 59 分 (也 就 是 86399 秒 ) 。 


9.16 ”小结 


本 章 介绍 了 iOs 表 格 的 用 法 ， 其 中 有 些 表 格 比较 简单 ， 有 些 则 比较 复杂 。 各 种 基本 的 iOS 表 格 都 讲 到 了 ， 包 括 简单 的 表格 、 可 供 编辑 的 表格 以 及 可 以 重 排 单 元 格 顺 
序 并 文 持 撤销 功能 的 表格 。 读 者 也 学 到 了 一 些 高 级 的 UI 元 件 ， 其 中 有 按 字母 排序 的 索引 列表 、 刷 新 控件 以 及 选取 器 视图 等 。 掌 握 了 本 章 所 讲 的 技巧 之 后 ， 你 就 可 以 为 
iPhone、iPad 及 iPod touch 构 建 出 一 大 批 基于 表格 的 应 用 程序 了 。 现 在 将 本 章 的 要 点 总 结 如 下 : 


-在 学 习 表 格 的 用 法 时 ， 一 定 要 明白 数据 源 方法 与 委托 方法 之 间 的 区 别 。 数 据 源 方法 用 来 向 表格 里 填充 有 意义 的 内 容 ， 而 委托 方法 则 用 于 响应 用 户 的 操作 。 


: 如果 应 用 程序 以 UITableView 为 中 心 ， 么 就 可 以 采用 UITableView-Conttollet 来 简化 程序 的 构建 过 程 。 不 过 ， 妆 程序 需要 直接 使 用 UITableView 的 时 候 ， 则 应 该 毫 
不 犹 了 豫 地 使 用 它 ， 尤 其 是 在 popovet 里 面 ， 或 是 在 与 分 栏 视 图 控制 器 相 搭 配 时 ， 更 应 如 此 。 在 必要 的 时 候 ， 应 该 明确 宣称 自己 所 写 的 类 支持 UITableViewDelegate 及 
UITableViewDataSource 3X; 


对 于 比较 大 的 有 序列 表 来 说 ， 索 引 是 一 种 快速 浏览 表格 的 好 办 法 。 在 编写 表格 的 时 候 ， 应 该 善 用 索引 ， 否 则 那些 比较 大 的 表格 就 不 便于 浏览 了 。 从 美观 角度 来 
讲 ， 分 组 表格 最 好 不 要 使 用 索引 。 


` 应 该 研究 一 下 编辑 功能 。 我 们 很 容易 就 为 用 户 提 供 编辑 表格 数据 的 功能 ， 而 且 写 好 的 代码 还 可 以 复 用 到 很 多 项 目 之 中 。 从 设计 程序 之 初 就 应 该 考虑 撤销 功能 。 
即便 一 开始 你 党 得 用 不 到 这 个 功能 ， 稍 后 也 有 可 能 会 改变 主意 。 


C 把 首 通 表格 转变 成 分 区 表格 是 相当 简单 的 。 你 应 该 用 本 章 所 介绍 的 办 法 ， 人 借助 谓词 ， 以 简单 的 数组 创建 出 表格 里 的 各 个 区 段 。 分 区 表格 能 够 更 加 有 条 理 地 展示 
数据 ， 而 且 还 支持 索引 ， 同 时 ， 开 发 者 也 可 以 把 易于 使 用 的 搜索 功能 集成 到 里 面 。 


. 数据 选取 器 是 一 种 非常 专业 的 控件 ， 很 适合 用 来 选取 日 期 和 时 间 。 而 选取 器 视图 则 提供 了 一 种 比较 通用 的 解决 方案 ， 它 需要 开发 者 编写 更 多 的 代码 才能 运作 。 


第 10 草 ”集合 视图 


IOS 6 引入 的 集合 视图 (collection view) 是 一 种 网 格 状 视 图 ， 用 来 排 布 其 中 的 各 个 单元 格 。 这 种 集合 视图 的 功能 远 远 超 过 标准 的 表格 ， 它 们 不 仅 仪 是 能 够 垂直 滚 
动 的 一 列 单元 格 。 集 合 视图 的 许多 概念 与 表格 相同 ， 但 却 更 加 强大 ， 也 更 为 灵活 。 开 友 者 可 以 用 集合 视图 创建 出 横向 滚动 的 列表 、 网 格 ， 以 及 一 些 特 殊 的 布局 ， 例 如 
加 形 布局 等 。 此 外 ， 该 类 还 能 通过 布局 规格 提供 内 置 的 视 党 效果 ， 并 且 支 持 很 多 有 用 的 特性 ， 例 如 深 动 之 后 目 动 就 位 。 


与 使 用 表格 时 一 样 ， 你 也 可 以 向 集合 视图 里 添加 大 量 的 实现 细节 。 本 章 将 介绍 集合 视图 的 一 些 基 本 知识 ， 包 括 它 的 数据 源 、 特 殊 用 途 的 控制 器 以 及 单元 格 等 。 读 
者 将 会 学 到 如 何 开 友 标 准 的 集合 视图 与 自 定义 的 集合 视图 ， 如 何在 视图 中 添加 特效 ,以 及 如 何 利用 内 置 的 动画 功能 来 创建 出 相当 高 效 的 交互 方式 ,。 


大 家 要 知道 ， 集 合 视图 是 非常 强大 的 ， 只 用 一 章 的 篇 幅 不 可 能 将 它 全 部 涵 芋 。 本 章 只 是 讲解 集合 视图 的 一 些 基 本 概念 。 学 会 了 这 部 分 内 容 之 后 ， 你 应 该 自己 去 探 
索 它 的 用 法 并 积 囚 使 用 经 验 。 


10.1 集合 视图 与 表格 的 异同 


UICollectionView 实 例会 把 各 项 数据 展示 成 一 份 有 序 的 集合 。 与 表格 视图 一 样 ， 集 合 视图 也 由 单元 格 、 头 部 及 尾部 构成 ， 而 且 由 数据 源 方法 及 委托 方法 所 驱动 。 
但 与 表格 不 同 的 地 方 在 于 ， 集 合 视图 还 引入 了 与 布局 有 天 的 类 ， 这 个 类 用 来 指定 各 条 目 应 该 如 何 摆 放 在 屏幕 上 。 该 类 负责 管理 每 个 单元 格 的 位 置 ， 使 得 对 应 的 条 目 可 
以 在 必要 时 出 现在 适当 的 地 方 。 


表 10-1 比 较 了 集合 视图 与 表格 这 两 种 布局 。 正 如 大 家 所 见 ， 两 者 都 提供 了 核心 的 视图 类 及 预 置 的 控制 器 类 。 这 些 类 都 依赖 于 数据 源 。 数 据 源 负责 填充 单元 格 ， 并 
提供 其 他 内 容 信息 。 此 外 ， 两 者 都 需要 通过 委托 来 啊 应 用 户 的 操作 。 


表 10-1 集合 视图 与 表格 之 间 的 对 比 


UICollectionView 


对 比 项 


证 dl 


| zs UICollectionViewController 

单元 格 、 补 充 视 图 (例如 头 部 和 尾部 )、 装 饰 
视图 (背景 图 版 以 及 视觉 饰 件 ) 

在 用 户 浏 览 的 时 候 会 实时 更 新 自己 ， 
前 数据 相符 


Tidi 
内 容 
由 用 户 所 触发 的 重 
新 载 人 


以 编程 方式 触发 的 
ca Ara A 


以 便 与 当 
特定 的 情况 下 会 使 用 刷新 控件 


UICollectionViewCell (itr dequeue- 
ReusableCellWithReuseIdentifier:- 


forIndexPath: 方法 获取 ) 


可 复 用 的 单元 格 


HÆ XB 来 和 注册 可 复 用 的 单元 格 、 补 充 视 
图 以 及 泌 饰 视图 


注册 


头 部 及 尾部 
p lectionViewLayout E 
iid UICollectionViewFlowLayout 
数据 源 

委托 

用 于 布局 的 委托 
索引 机 制 

滚动 方 回 


NT KA zl EH 
T CUN M 未 


JICollectionViewDelegateFlowLayout 
通过 区 段 与 条 目 来 定位 

水 平 或 垂直 

通过 目 定 尺 的 布局 来 设置 


表 格 
UITableView 


UITableViewController 


Hout. 8b. Beeb 


刷新 控件 (UIRefreshControl) 


reloadData 


UITableViewCell (通过 dequeue- 


'eusableCellWithIdentifier:for- 


IndexPath: JyikikH) 


用 类 或 XIB 来 注册 可 复 用 的 单元 格 
UITableViewHeaderFooterView 


不 适用 


UITableViewDeiegate 
不 适用 
通过 区 段 与 行 来 定位 

He ET 


不 适用 


两 者 之 间 还 是 有 许多 根本 区 别 的 ， 我 们 先 从 不 大 起 眼 的 索引 路 径 说 起 。 这 两 个 类 都 把 区 段 用 作 主 要 的 分 组 方式 ， 每 个 区 段 里 面 都 含有 一 些 单元 格 ， 这 些 单元 格 又 
都 有 各 自 的 索引 号 。 由 于 集合 视图 既 可 以 垂直 滚动 ， 也 可 以 水 平 滚动 ， 所 以 它 使 用 的 术语 就 与 表格 不 同 了 。 表 格 采 用 区 段 和 行 来 定位 单元 格 ， 而 集合 视图 则 采用 区 段 
和 条 目 来 定位 。iOS 6 更 新 了 NSIndexPath 类 ， 以 适应 这 一 变化 。 


集合 视图 引入 了 一 种 新 的 内 容 一 一 装饰 视图 ， 这 种 视图 可 以 提供 诸如 背面 图 版 (backdrop) 等 视觉 增强 效果 。 对 于 集合 视图 来 说 ， 单 元 格 与 滚动 方向 只 是 最 基本 
的 定制 方式 。 开 发 者 可 以 使 用 所 能 想到 的 任何 隐喻 来 定制 整套 视图 的 样 够 ， 使 其 与 自己 所 要 表达 的 概念 相 一 致 。 集 合 视图 的 头 部 与 尾部 也 与 表格 视图 不 同 ， 它 把 这 两 
者 转化 成 了 补充 视图 ， 并 且 提 供 了 比 表格 稍微 灵活 一 些 的 AP1。 


两 者 在 实现 层面 的 区 别 


编写 实际 的 程序 时 ， 构 建 表格 视图 和 构建 集合 视图 所 用 的 代码 有 几 个 地 方 是 不 同 的 。 集 合 视 图 不 太 允 许 数 据 的 延迟 加 载 。 有 一 条 经 验 : 创建 集合 视图 的 时 候 ， 为 
该 视图 提供 内 容 的 数据 源 必 须 完全 准备 好 ， 哪 怕 它 现在 只 能 为 视图 里 的 少数 几 个 单元 格 提供 数据 ， 甚 至 暂时 没有 单元 格 数 据 都 可 以 ， 但 只 要 它 自身 准备 好 就 行 ， 稍 后 
我 们 可 以 再 从 程序 的 其 他 地 方 加 载 数据 。 


我 们 不 能 等 到 程序 执行 初始 化 方法 、loadView 方 法 或 viewDidLoad 方 法 的 时 候 表 准备 数据 源 ， 而 是 必须 首先 把 它 准备 好 。 可 以 在 应 用 程序 委托 中 准备 ， 也 可 以 在 
实例 化 集合 视图 并 将 其 添加 到 其 他 视图 之 前 ， 或 是 在 把 新 的 集合 视图 控制 器 设 为 其 他 对 象 的 子 控制 器 之 前 把 数据 源 准备 好 。 要 是 没准 备 好 ， 程 序 就 会 衣 演 ， 而 这 肯定 
不 是 我 们 想 要 的 用 户 体验 。 


展示 集合 视图 之 前 ， 一 定 要 把 集合 视图 的 布局 对 象 [完全 建立 好 。 大 家 在 本 章 稍 后 的 解决 方案 里 面 会 看 到 ， 我 们 需要 把 布局 对 象 的 所 有 细节 都 设置 好 ， 包 括 滚动 
方向 以 及 其 他 不 依赖 于 委托 回调 的 属性 。 只 有 在 准备 好 这 些 之 后 ， 才 能 创建 并 初始 化 集合 视图 : 


MyCollectionController *mcc = [[MyCollectionController alloc] 


initWithCollectionViewLayout:layout]; 


如 果 传 给 layout 人 参数 的 值 是 nil， 融 会 抛 出 异 剃 。 


在 集合 视图 的 生命 期 中 ， 并 不 是 只 能 使 用 一 种 布局 。 开 发 者 可 以 通过 collectionView-Layout 属 性 来 直接 访问 集合 视图 的 布局 。 修 改 这 个 属性 之 后 ， 视 图 就 会 以 不 
市 动画 的 方式 立即 更 新 其 布局 。iO3 7 提供 了 一 个 简单 的 方法 ， 能 够 用 动画 效果 来 展示 布局 的 变更 过 程 : 


- (void)setCollectionViewLayout: (UICollectionViewLayout *)layout 
animated: (BOOL)animated completion: (void (^) (BOOL finished))completion 


苹果 公司 在 iOS 7 中 引入 了 一 套 机 制 ， 用 于 创建 更 为 复杂 且 更 具 交 互 性 的 切换 效果 。 这 个 问题 已 经 超出 了 本 书 的 范围 ， 不 过 你 可 以 在 苹果 公司 的 iOS Developer 
Center 中 查看 《UlCollectionView Class Reference》 以 获知 更 多 信息 ， 也 可 以 在 Xcode 的 iOS 7docset 中 查询 此 信息 。 


[1] 也 就 是 UICollectionViewLayout 类 型 的 对 象 。 译 者 注 


10.2 ”建立 集合 视图 


与 表格 一 样 ， 集 合 视 图 也 有 两 种 用 法 ， 一 种 是 直接 使 用 集合 视图 ， 另 一 种 是 使 用 系统 预 置 的 控制 器 。 开 发 者 可 以 构建 一 份 单 独 的 集合 视图 实例 ， 并 把 它 添加 到 界 
面 中 ， 也 可 以 使 用 更 为 方便 的 UICollectionViewController 对 象 ， 该 对 象 是 个 预先 制备 好 的 视图 控制 器 ， 其 中 市 有 一 份 集合 视图 。 这 个 控制 器 会 自动 把 视图 的 数据 源 及 
委托 设置 成 该 控制 器 本 身 ， 而 且 还 会 宣称 自己 遵从 两 个 相 天 的 协议 。 这 样 的 集合 视图 控制 器 既 可 以 用 作 其 他 容器 (比如 导航 控制 器 、 标 签 栏 控制 器 、 分 栏 视 图 控制 
器 、 页 面 视 图 控制 器 等 ) 的 子 控制 器 ， 也 可 以 独立 展示 出 来 。 


Qi 与 表格 视图 一 样 ， 集 合 视 图 也 有 delegate 及 dataSource 属 性 。UICollectionView-FlowLayout 类 期 望 集合 视图 的 delegate 还 能 够 遵从 UICollectionViewDelegate- 


FlowLayout 协 议 。 开 发 者 可 以 在 集合 视图 控制 器 里 面 实现 这 三 个 协议 山中 的 相关 方法 。 


[1] 另外 两 个 协议 是 UICollectionViewDelegate 和 UICollectionViewDataSoutce。 


译 者 注 


10.2.1 ”通过 控制 器 使 用 集合 视图 


构建 控制 器 的 时 候 ， 首 先 要 创建 并 设置 好 布局 对 象 ， 然后 分 配 新 的 实例 ， 并 用 准备 好 的 布局 对 销 初 始 化 它 : 


UICollectionViewFlowLayout *layout = 
[[UICollectionViewFlowLayout alloc] init]; 


layout.scrollDirection - UlCollectionViewScrollDirectionHorizontal; 


MyCollectionController *mcc - [[MyCollectionController alloc] 
initWithCollectionViewLayout:layout]; 


上 上面 代 码 采 用 UICollectionViewFlowLayout 作 为 布局 对 象 ， 并 且 使 用 它 的 默认 配置 ， 只 是 修改 了 一 下 深 动 方 同 。 在 本 章 后 面 的 解决 方案 中 ， 大 家 会 看 到 ， 我 们 可 
以 在 布局 对 象 上 面 配置 更 多 的 属性 。 通 冲 我 们 都 会 再 设置 一 些 属性 ， 或 是 从 系统 所 提供 的 类 中 继承 子 类 ， 并 在 子 类 里 面 添加 自 定 义 的 行为 代码 。 


一 般 来 说 ， 使 用 UICollectionViewFlowLayout 类 就 行 了 。 集 合 视图 里 的 许多 布局 任务 ， 它 都 能 够 完成 。 我 们 可 以 用 它 构建 出 基本 的 界面 。 在 默认 状态 下 ， 每 个 区 
段 都 会 根据 屏幕 内 容 自行 调整 该 区 段 中 的 条 目 ， 而 开发 者 则 可 以 指定 区 段 之 间 、 线 条 之 间 以 及 条 目 之 间 的 空白 尺寸 等 。 下 一 节 会 详细 讲述 
UlCollectionViewFlowLayout 里 面 许多 可 供 调 整 的 部 分 ， 大 家 将 看 到 它 的 可 定制 程度 相当 高 。 


UICollectionViewFlowLayout 类 的 父 类 叫 作 UICollectionViewLayout， 它 是 个 可 供 继承 的 抽象 基 类 ， 不 过 ， 绝 大 部 分 情况 下 都 不 应 该 从 它 继承 子 类 ， 而 是 应 该 从 
UICollectionViewFlowLayout 继 承 。 开 发 者 并 不 需要 直接 使 用 这 个 父 类 。 


Qi. 如 果 要 继承 布局 类 的 子 类 ， 请 参阅 UICollectionViewLayout 的 文档 。 这 个 UICollectionViewFlowLayout 父 类 的 文档 里 面 ， 规 范 地 列 出 了 各 种 可 供 定制 的 方 


10.2.2 ”直接 使 用 集合 视图 


如 果 想 建立 嵌入 其 他 视图 之 中 的 集合 视图 (也 就 是 不 带 UlCollectionView-Controller 的 集合 视图 ) ， 就 先 创建 好 布局 对 象 ， 然 后 用 布局 对 象 来 创建 集合 视图 ， 并 
设置 数据 源 及 委托 。UICollectionViewFlowLayout 对 象 会 使 用 开发 者 经 由 delegate 属 性 赋 给 集合 视图 的 委托 : 


UICollectionViewFlowLayout *layout = 
[[UICollectionViewFlowLayout alloc] init]; 
layout.scrollDirection = UlCollectionViewScrollDirectionHorizontal; 


collectionView = [[UICollectionView alloc] initWithFrame:CGRectZero 
collectionViewLayout:layout]; 

collectionView.dataSource - self; 

collectionView.delegate = self; 


10.2.3 ”数据 源 与 委托 


管理 集合 视图 的 视图 控制 器 宣称 自己 实现 了 UlCollectionViewDataSource 及 UICollectionViewDelegate 协 议 。 但 与 表格 不 同 的 是 ， 如 果 使 用 流 式 布局 (flow 
layout) ， 那 么 控制 器 还 会 宣称 自己 实现 了 UlCollectionViewDelegateFlowLayout 协 议 。 


UlCollectionViewDelegateFlowLayout 协 议 通 过 一 系列 回调 方法 来 给 集合 视图 的 布局 对 象 提供 布局 信息 。 集 合 视图 的 delegate 遵 从 了 这 一 协议 ， 也 就 是 说 ,我 
们 无 须 另外 用 一 个 名 为 delegateFlowLayout 的 属性 来 表示 实现 了 该 协议 的 对 象 。 


与 表格 视图 一 样 ， 数 据 源 也 负责 提供 每 个 区 段 及 区 段 内 每 个 条 目的 信息 ， 并 根据 需求 返回 对 应 的 单元 格 以 及 集合 视图 上 面 的 其 他 部 件 。 委 托 负 责 处 理 用 户 操作 ， 
并 对 用 户 的 改动 请 求 做 出 有 效 回 应 。 而 UICollectionViewDelegateFlowLayout 则 负责 提供 每 个 区 段 的 详细 布局 信息 ， 在 大 多 数 情 况 下 ， 它 所 规定 的 方法 都 是 可 选 的 。 
下 一 节 将 会 讲解 流 式 布局 以 及 与 之 相关 的 委托 回调 。 


10.3” 流 式 布局 


由 UICollectionViewFlowLayout 类 所 提供 的 流 式 布局 会 在 应 用 程序 里 创建 出 网 格 状 的 界面 。 它 们 有 一 些 内 置 的 属性 ， 开 发 者 既 可 以 直接 设置 这 些 属性 ， 也 可 以 通 
过 委托 回调 来 提供 属性 值 。 这 些 属性 用 来 指定 布局 对 象 应 该 如 何 配置 自己 ,才能 把 各 条 目 适 当地 显示 在 屏幕 上 面 。 从 最 入 单 的 角度 来 说 ， 这 些 布局 属性 可 以 看 作 一 份 
与 几何 特征 有 关 的 字典 ， 它 们 描述 了 行 间 距 、 缩 进 ， 以 及 条 目 之 间 的 留 日 等 特征 。 


10.3.1 IAW 


scrollIDirection 属 性 决定 了 视图 中 的 区 段 是 水 平 排列 (UlCollectionViewScroll-DirectionHorizontal) 还 是 垂直 排列 
(UlCollectionViewScrollDirectionVertical) 。 图 10-1 中 的 左右 两 幅 截 图 ， 分 别 演示 了 水 平 的 流 式 布 局 以 及 垂直 的 流 式 布局 ， 除 了 方向 不 同 之 外 ， 这 两 种 布局 方式 在 
其 他 方面 都 是 相似 的 。 每 一 个 区 段 内 的 条 目 会 根据 可 用 的 空间 自动 换行 。iPhone 竖 屏 模式 的 垂直 空间 要 多 于 水 平 空 间 ， 所 以 水 平 布局 下 的 每 个 区 段 都 会 显得 比 垂直 布 
局 下 的 区 段 更 罕 。 


10.3.2 条 目的 尺寸 以 及 行 间距 


itemSize 属 性 可 用 来 指定 屏幕 上 每 个 条 目的 默认 大 小 ， 就 像 图 10-1 中 的 小 方块 那样 。minimumLineSpacing 及 minimumlnteritemSpacing 属 性 规定 了 每 个 区 段 
内 的 条 目 之 间 应 该 距离 多 远 。 行 间距 (line spacing) 总 是 表示 相 邻 两 行 之 间 的 距离 ， 在 水 平 布局 下 行 是 垂直 方向 的 ， 而 在 垂直 布局 下 行 则 是 水 平方 向 的 。 比 方 说 ， 在 
图 10-1 左 侧 截 图 中 ， 行 间距 指 的 就 是 S0 (0) 和 S0 (6) 之 间 的 距离 ， 而 在 右 侧 截图 中 ， 指 的 则 是 S0 (0) 和 SO0 (4) 之 间 的 距离 。 条 目 间距 (item spacing) 与 行 间 
距 的 延伸 方向 相互 垂直 ， 它 表示 相 邻 两 个 条 目 之 间 的 空隙 ， 例 如 S0 (0) 和 S0 (1) 之 间 的 距离 ， 以 及 S0 (1) 和 S0 (2) 之 间 的 距离 等 。 
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图 10-1 集合 视图 的 总 体 滚动 方向 可 以 设 为 水 平 AMAA ME) RA (如 右 仙 截图 所 示 ) 。 左 侧 鹤 图 中 的 集合 视图 可 以 左右 滚动 ， 而 右 侧 蕉 图 中 的 集合 视图 则 是 
上 下 滚动 的 。 采 用 流 式 布局 排列 各 条 目的 时 候 ， 它 会 在 到 达 每 一 行 的 末尾 之 后 自动 换行 。 在 左 侧 截图 中 ， 每 个 纵向 的 行 都 有 6 个 条 目 ， 而 在 右 侧 蕉 图 中 ， 每 个 横向 的 行 


则 有 4 个 条 目 。 每 个 区 段 内 均 包含 12 个 条 目 


图 10-2 演 示 了 这 两 个 属性 ， 它 使 用 的 是 垂直 流 式 布局 。 在 左 侧 截图 中 ， 行 间距 与 条 目 间距 都 是 10 个 点 。 而 在 中 间 截 图 中 ， 我 们 把 行 间距 增 大 到 50 点 。 这 个 间距 出 
现在 相 邻 两 行 条 目 之 间 ， 布 局 对 象 在 排 布 各 条 目的 时 候 ， 如 果 到 了 某 一 行 的 尾部 ， 会 把 下 一 个 条 目 摆 在 下 一 行 开头 。 右 侧 截 图 把 条 目 间距 扩大 为 30 点 。 条 目 辣 距 表现 
为 水 平方 向 上 的 间隔 距离 ， 也 融 是 相 邻 两 个 条 目 之 间 的 间隔 距离 。 
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图 10-2 ”最 小 行距 (minimumLineSpacing) 与 最 小 条 目 间 距 (minimumlInteritemSpacing) 决定 了 每 个 区 段 内 的 条 目 应 该 如 何 排列 。 而 条 目 尺 寸 (temSize) 则 决定 了 每 个 


单元 格 的 大 小 。 左 侧 堆 图 采用 默认 的 间距 。 中 间 截 图 把 行 间距 扩大 到 50 点 。 右 侧 截 图 把 条 目 间距 扩大 到 30 点 


EjiOS 6 及 后 续 版 本 新 引入 的 某 些 布局 机 制 一 样 ， 这 些 设置 也 只 是 表达 对 系统 的 一 种 请 求 。 说 得 更 明确 一 些 ， 就 是 实际 间距 可 能 会 超出 我 们 指定 的 值 ， 不 过 ， 系 统 
在 排版 时 会 尽量 满足 开发 者 所 指定 的 最 小 值 。 

开发 者 可 以 直接 设置 上 述 属性 ， 如 果 这 样 做 的 话 ， 所 设 定 的 值 束 会 成 为 整个 集合 视图 的 默认 值 。 另 外 ， 还 可 以 在 UlCollectionViewDelegateFlowLayout 协 议 的 委 
托 回调 方法 中 以 代码 的 形式 来 指定 它们 。 在 程序 运行 的 时 候 指 定 这 些 值 ， 要 比 直 接 设 置 默认 值 更 为 精细 ， 因 为 可 以 具体 指定 每 个 区 段 内 每 个 条 目的 相关 特征 ， 而 不 是 
一 次 性 地 影响 集合 视图 内 的 所 有 条 目 。 下 面 的 方法 可 用 来 指定 条 目的 尺寸 以 及 最 小 间距 : 


: collectionView: layout: sizeForltemAtIndexPath: 一 一 该 方法 与 itemSize 属 性 相对 应 ， 不 过 它 可 以 具体 指定 每 个 条 目的 尺寸 。 


: collectionView: layout: minimumLineSpacingForSectionAtIndex: 该 方法 与 minimumLineSpacing 属 性 相对 应 ， 但 是 它 可 以 具体 控制 每 个 区 段 内 的 最 小 


行 间 距 。 


: collectionView: layout: minimumlnteritemSpacingForSectionAtIndex: 该 方法 与 minimumlIntetitemSpacing 属 性 相对 应 ， 然 而 它 可 以 具体 控制 每 个 区 段 


内 的 最 小 条 目 间 距 。 


这 三 个 方法 之 中 ， 第 一 个 方法 在 开发 1OS 程 序 的 时 候 最 容易 用 到 。 它 使 得 开发 者 可 以 构建 出 条 目 大 小 各 不 相同 的 集合 视图 ， 而 不 是 像 图 10-2 那 样 ， 所 有 条 目的 尺寸 
都 完全 一 样 。 在 本 章 稍 后 的 图 10-4 中 ， 大 家 可 以 看 到 一 种 流 式 布局 ， 它 能 够 根据 大 小 多 变 的 单元 格 来 调整 自己 。 


10.3.3” 头 部 与 尾部 的 尺寸 


headerReferenceSize 及 footerReferenceSize 属 性 定义 了 区 段 的 头 部 和 尾部 应 该 多 宽 或 多 高 。 请 注意 对 比 图 10-3 顶 部 两 张 截图 与 底部 两 张 截 图 ， 看 看 这 两 个 属性 
在 两 种 布局 方向 上 分 别 是 如 何 延伸 的 。 顶 部 两 张 截 图 使 用 的 是 水 平 布局 ， 我 们 把 这 两 个 属性 的 宽度 设 为 60 点 ; 底部 两 张 截图 采用 垂直 布局 ， 我 们 把 这 两 个 属性 的 高 度 
设 为 30 点 。 昌 说 开发 者 提供 的 是 完整 的 CGSize 结 构 ， 但 是 布局 对 象 每 次 只 会 使 用 其 中 的 一 个 字段 ， 具 体 使 用 哪个 字段 ， 要 根据 布局 方向 来 确定 。 在 水 平 布局 下 ， 使 用 
宽度 字段 ; 在 垂直 布局 下 ， 使 用 高 度 字 段 。 
下 面 两 个 回调 方法 用 于 生成 图 10-3 这 样 的 版 式 。 虽 说 布局 对 象 一 次 只 会 用 到 一 个 字段 ， 但 这 两 个 方法 还 是 会 返回 包含 宽度 值 与 高 度 值 的 完整 结构 体 。 如 果 委 托 没 
有 实现 这 些 方法 ， 那 么 布局 对 象 就 会 采用 本 节 开 头 提 到 的 两 个 属性 : 
- (CGSize) collectionView: (UICollectionView *)collectionView 


layout: (UICollectionViewLayout *)collectionViewLayout 
referenceSizeForHeaderInSection: (NSInteger) section 


return CGSizeMake(60.0f, 30.0£); 


- (CGSize) collectionView: (UICollectionView *)collectionView 
layout: (UICollectionViewLayout *)collectionViewLayout 


referenceSizeForFooterInSection: (NSInteger)section 


return CGSizeMake(60.0f, 30.0f); 
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图 10-3 ”区 段 内 边 距 决定 了 区 段 内 的 所 有 条 目 与 外 围 视 图 边界 之 间 的 空隙 。 顶 部 两 张 截图 采用 水 平 布 局 ， 底 部 两 张 截图 采用 重 直 布局 。 在 这 四 张 截图 中 ， 顶 部 内 边 距 都 
是 50 点 ， 底 部 内 边 距 都 是 30 点 ， 左 侧 内 边 距 与 右 侧 内 边 距 都 是 10 点 


10.3.4 Angie 


最 小 行 间距 及 最 小 条 目 间距 两 个 属性 定义 了 区 段 内 的 某 个 条 目 与 其 他 条 目 之 间 的 位 置 关 系 。 与 之 相对 ，sectionlnset 属 性 则 摘 述 了 区 段 内 所 有 条 目的 总 体 边 界 与 外 
围 的 集合 视图 边界 之 间 的 距离 。 这 段 填 充 距 离 ， 既 会 影响 区 段 与 其 头 部 和 尾部 之 间 的 距离 ， 又 会 影响 两 个 区 段 乙 间 的 距离 。 


每 个 内 边 距 (inset) 都 是 由 一 组 ftop，left，bottom，right} 值 构成 的 。 图 10-3 演 示 了 内 边 距 对 集合 视图 的 影响 。 图 10-3 中 的 四 张 截图 所 采用 的 内 边 距 完全 相 
同 ， 都 是 顶部 50 点 、 底 部 30 点 、 左 右 两 侧 各 10 点 : 


UIEdgeInsetsMake(50.0f, 10.0f, 30.0f, 10.0f) 


顶部 两 张 截图 采用 水 平 的 流 式 布局 ， 底 部 两 张 截图 采用 垂直 的 流 式 布局 。 读 者 可 以 看 到 ，sectionlnset 属 性 在 这 些 情况 下 是 如 何 影响 排版 的 。 它 会 在 内 容 条 目 
(content item) [与 外 围 容器 (enclosing container) 之 间 填 入 空白 。 在 水 平 布局 下 ， 内 容 条 目 会 在 垂直 方向 上 调整 自己 ， 使 其 顶 边 与 外 围 视图 的 顶 边 之 间 能 够 留 


有 一 定 空 除 ， 同 时 还 会 在 水 平方 向 上 调整 自己 ， 使 其 左右 边界 能 够 和 区 段 的 头 部 及 尾部 乙 间 分 别 留 出 一 定 距 离 。 在 垂直 布局 下 ， 内 容 条 目的 上 下 边界 则 要 和 区 段 的 头 
部 及 尾部 乙 间 分 别 留 有 一 定 空 除 。 同 时 ， 其 左右 边界 也 必须 与 外 围 集合 视图 的 左右 边界 之 间 留 出 距离 。 


[I] 可 以 理解 为 “由 某 区 段 内 的 全 部 条 目 所 构成 的 整体 ”。- 译 者 注 


10.4 解决 方案 : 采用 沅 式 布局 的 简单 集合 视图 


解决 方案 10-1 制 作 了 简单 的 集合 视图 控制 器 ， 并 且 使 开发 者 可 以 指定 它 的 头 部 及 尾部 。 这 条 解决 方案 编写 了 关键 的 数据 源 方法 与 委托 方法 ， 以 便 实现 简单 的 网 格 
状 流 式 布局 。 苹 果 公 司 提供 了 很 多 属性 ， 开 发 者 可 以 通过 与 集合 视图 有 关 的 一 些 委托 方法 ， 以 及 UlCollectionViewDelegateFlowLayout 协 议 中 的 委托 方法 来 提供 与 这 
些 属 性 相对 应 的 值 。 你 可 以 在 其 他 项 目 里 沿用 本 条 解决 方案 所 提供 的 属性 ， 并 且 稍 微调 整 一 下 源 代 码 ， 修 改 视 图 中 的 区 段 数量 、 每 个 区 段 内 的 条 目 数量 ， 以 及 其 他 影 
响 总 体 版 式 的 布局 细节 。 


解决 方案 10-1 ”使 用 流 式 布局 的 简单 集合 视图 控制 器 


@interface TestBedViewController : UICollectionViewController 
// Layout and collection view configuration 

Gproperty (nonatomic, assign) BOOL useHeaders; 

@property (nonatomic, assign) BOOL useFooters; 

Gproperty (nonatomic, assign) NSInteger numberOfSections; 
@property ( ) 


@end 


nonatomic, assign) NSInteger itemsInSection; 


@implementation TestBedViewController 


#pragma mark Flow Layout 

- (CGSize)collectionView: (UICollectionView *)collectionView 
layout: (UICollectionViewLayout *)collectionViewLayout 
referenceSizeForHeaderInSection: (NSInteger)section 


return self.useHeaders ? CGSizeMake(60.0f, 30.0f) : CGSizeZero; 


- (CGSize)collectionView: (UICollectionView *)collectionView 
layout: (UICollectionViewLayout *)collectionViewLayout 
referenceSizeForFooterInSection: (NSInteger)section 


return self.useFooters ? CGSizeMake(60.0f, 30.0f) : CGSizeZero; 


#pragma mark Data Source 

// Number of sections total 

- (NSInteger)numberOfSectionsInCollectionView: 
(UICollectionView *)collectionView 


return self.numberOfSections; 


// Number of items per section 
- (NSInteger)collectionView: (UICollectionView *)collectionView 
numberOfItemsInSection: (NSInteger)section 


return self.itemsInSection; 


// Dequeue and prepare a cell 

- (UICollectionViewCell *)collectionView: 
(UICollectionView *)aCollectionView 
cellForItemAtIndexPath: (NSIndexPath *) indexPath 


UICollectionViewCell *cell = [self.collectionView 
dequeueReusableCellWithReuseIdentifier:G"cell" 
forlIndexPath:indexPath]; 


cell.backgroundColor = [UIColor whiteColor]; 
cell.selectedBackgroundView - 

[[UIView alloc] initWithFrame:CGRectZero] ; 
cell.selectedBackgroundView.backgroundColor = 

[[UIColor blackColor] colorWithAlphaComponent:0.5f]; 


return cell; 


// If using headers and footers, dequeue and prepare a view 

- (UICollectionReusableView *)collectionView: 
(UICollectionView *)aCollectionView 
viewForSupplementaryElementOfKind: (NSString *)kind 
atIndexPath: (NSIndexPath *)indexPath 


if (kind == UICollectionElementKindSectionHeader) 
UICollectionReusableView *header - [self.collectionView 
dequeueReusableSupplementaryViewOfKind: 
UICollectionElementKindSectionHeader 


withReuseIdentifier:e"header" forIndexPath: indexPath] ; 
header.backgroundColor = [UIColor blackColor] ; 
return header; 


j 


else if (kind == UICollectionElementKindSectionFooter) 
{ 
UICollectionReusableView *footer = [self.collectionView 
dequeueReusableSupplementaryViewOfKind: 
UICollectionElementKindSectionFooter 
withReuseIdentifier:e"footer" forIndexPath:indexPath] ; 
footer.backgroundColor = [UIColor darkGrayColor] ; 
return footer; 


} 


return nil; 


#pragma mark Delegate methods 
- (void)collectionView: (UICollectionView *)aCollectionView 
didSelectItemAtIndexPath: (NSIndexPath *)indexPath 


NSLog (@"Selected %@", indexPath) ; 


- (void)collectionView: (UICollectionView *) aCollectionView 
didDeselectItemAtIndexPath: (NSIndexPath *)indexPath 


NSLog (@"Deselected $9", indexPath); 


#pragma mark Setup 
- (void) viewDidLoad 
{ 
[super viewDidLoad] ; 
// Register any cell and header/footer classes for re-use queues 
[self.collectionView 
registerClass:[UICollectionViewCell class] 
forCellWithReuseIdentifier:G?"cell"]; 
[self.collectionView 
registerClass: [UICollectionReusableView class] 
forSupplementaryViewOfKind:UICollectionElementKindSectionHeader 
withReuseIdentifier:e"header"]; 
[self.collectionView 
registerClass:[UICollectionReusableView class] 
forSupplementaryViewOfKind:UICollectionElementKindSectionFooter 
withReuselIdentifier:@"footer"] ; 


self.collectionView.backgroundColor = [UIColor lightGrayColor] ; 


// Allow users to select/deselect items by tapping 
self.collectionView.allowsMultipleSelection = YES; 


- (instancetype)initWithCollectionViewLayout: (UICollectionViewLayout *) layout 
{ 
self = [super initWithCollectionViewLayout: layout] ; 
if (self) 
{ 
// Set some reasonable defaults 
self.useFooters = NO; 
self.useHeaders = NO; 
self.numberOfSections = 1; 
self.itemsInSection = 1; 


| 


return self; 


} 


@end 


// From the application delegate 
= (BOOL) application: (UIApplication *)application 
didFinishLaunchingWithOptions: (NSDictionary *) launchOptions 


_window = [[UIWindow alloc] 
initWithFrame: [[UIScreen mainScreen] bounds] ]; 
_window.tintColor = COOKBOOK PURPLE COLOR; 


// Create the layout and then pass to our collection VC 
UICollectionViewFlowLayout *layout = 
[[UICollectionViewFlowLayout alloc] init]; 
TestBedViewController *tbvc - [[TestBedViewController alloc] 
initWithCollectionViewLayout:layout] ; 
tbvc.edgesForExtendedLayout = UIRectEdgeNone; 


// Configure layout and collection view properties 
layout.itemSize = CGSizeMake(50.0f, 50.0f); 
layout.sectionInset - 
UIEdgeInsetsMake(10.0, 10.0f, 50.0f, 10.0f); 
layout,scrollDirection s 
UICollectionViewScrollDirectionVertical; 
layout.minimumLineSpacing = 10.0f; 
layout.minimumInteritemSpacing - 10.0f; 
tbvc.numberOfSections - 10; 
tbvc.itemsInSection = 12; 
tbvc.useHeaders - YES; 


tbvc.useFooters - YES; 

UINavigationController *nav - [[UINavigationController alloc] 
initWithRootViewController:tbvc]; 

 window.rootViewController - nav; 


[ window makeKeyAndVisible]; 
return YES; 


获取 解决 方案 代码 
访问 https://github.com/erica/iOS-7-Cookbook 网 页 ， 并 打开 “C10Collections” 文 件 夹 ， 即 可 找到 与 本 章 中 的 解决 方案 相对 应 的 完整 范例 项 目 。 


代码 中 的 两 个 布尔 属性 分 别 用 来 决定 集合 视图 是 否 使 用 头 部 及 尾部 。 如 果 使 用 的 话 ， 可 以 通过 解决 方案 10-1 中 的 前 两 个 方法 来 提供 与 headerReferenceSize 及 
footerReferenceSize 相 对 应 的 值 。 这 两 个 方法 定义 在 #pragma mark Flow Layout 指 令 下 方 。UlCollection-ViewDelegateFlowLayout 协 议 的 委托 方法 如 果 把 0 作为 
头 部 或 尾部 的 尺寸 返回 给 调用 者 ， 就 表明 集合 视图 的 相关 区 段 不 需要 使 用 头 部 或 尾部 。 若 是 返回 其 他 尺寸 ， 那 么 集合 视图 还 会 继续 询问 将 要 用 作 头 部 或 尾部 的 补充 视 
图 是 什么 。 


在 数据 源 中 使 用 单元 格 或 补充 视图 之 前 ， 一 定 要 先 把 它们 注册 好 。 解 决 方案 10-1 在 viewDidLoad 方 法 里 面 注 册 了 与 它们 相对 应 的 类 。 注 册 好 之 后 ， 就 可 以 根据 需 
要 从 队列 里 面 取 出 这 些 实例 了 。 开 发 者 无 须 检查 取出 来 的 实例 是 否 可 用 ， 因 为 负责 从 队列 中 取出 实例 的 方法 会 在 必要 时 自行 创建 并 初始 化 相关 实例 。 


笔者 党 得 你 应 该 研究 一 下 解决 方案 10-1 中 的 范例 代码 ， 并 且 试 着 调整 与 布局 相关 的 每 个 值 和 每 个 回调 方法 (前 一 节 的 那些 图 就 是 通过 这 种 手段 制作 出 来 的 ) ， 看 
看 它们 对 集合 视图 的 轧 体 版 式 及 样 狗 有 什么 影响 。 解 决 方案 10-1 是 个 很 好 的 出 友 点 ， 读 者 可 以 由 此 来 测试 集合 视图 ， 并 观察 每 个 属性 怎样 影响 最 终 的 版 式 。 


10.5 解决 万 案 : 目 定 义 单 元 格 


解决 方案 10-1 创 建 出 来 的 物件 ， 其 大 小 完全 相同 ， 不 过 ， 我 们 未 必 非 要 用 尺寸 完全 一 致 的 物件 来 填充 集合 视图 。 在 流 式 布局 之 下 ， 开 发 者 可 以 创建 出 图 10-4 这 样 
相当 多 变 的 界面 。 解 决 方案 10-2 改 编 了 原 有 的 集合 视图 ， 并 创建 了 一 些 自 定义 的 单元 格 ， 以 便 实现 出 丰富 多 彩 的 界面 。 这 些 单元 格 里 面 都 含有 UllmageView (图 像 视 
图 ) 。 系 统 会 向 集合 视图 的 数据 源 方法 查询 “位 于 某 索引 路 径 处 的 条 目 是 何 尺 寸 ”， 而 该 方法 则 会 把 图 像 的 大 小 返回 给 系统 。 


- (CGSize) collectionView: (UICollectionView *)collectionView 
layout: (UICollectionViewLayout*)collectionViewLayout 
sizeForItemAtIndexPath: (NSIndexPath *)indexPath 


UIImage *image = artDictionary [indexPath] ; 
return image.size; 


为 了 创建 自 定 义 的 单元 格 ， 我 们 从 UICollectionViewCell 中 继承 了 子 类 ， 并 且 把 新 的 视图 添加 到 单元 格 的 contentView 之 中 。 这 条 解决 方案 给 contentView 里 面 添 
加 了 一 个 UlImageView 类 型 的 子 视图 ， 并 且 用 imageView 属 性 来 表示 这 个 子 视图 。 当 系统 向 集合 视图 索要 单元 格 的 时 候 ， 数 据 源 方法 会 把 自 定 义 的 图 像 添加 到 
imageView 里 面 ， 而 负责 布局 的 委托 方法 则 会 向 系统 提供 单元 格 的 尺寸 。 


图 10-4 在 流 式 布局 下 ， 集 合 视 图 中 的 各 条 目 既 可 以 呈现 基本 的 网 格 状 ， 也 可 以 各 自 拥 有 不 同 的 高 度 及 宽度 


解决 方案 10-2 ”对 集合 视图 里 的 单元 格 进行 定制 


Ginterface ImageCell : UICollectionViewCell 
Gproperty (nonatomic) UIImageView *imageView; 
@end 


@implementation ImageCell 


- (instancetype) initWithFrame: (CGRect) frame 


| 
self = [super initWithFrame: frame] ; 
if (self) 
| 
_imageView = [[UIImageView alloc] initWithFrame: 
CGRectInset(self.bounds, 4.0f, 4.0f)]; 
 imageView.autoresizingMask - 
UIViewAutoresizingFlexibleWidth | 
UIViewAutoresizingFlexibleHeight; 
[self.contentView addSubview: imageView]; 
| 
return self; 
| 
@end 


10.6 ”解决 方案 : 水 平 滚动 的 列表 


用 集合 视图 可 以 出 创建 水 平 滚动 的 列表 ， 而 不 像 表 格 视 图 那样 ， 只 能 创建 出 和 斑 直 滚动 的 列表 。 如 果 想 实现 水 平 滚动 ， 束 需要 考虑 几 件 事情 ， 其 中 的 主要 问题 是 : 
在 流 式 布局 之 下 ， 区 上段 内 的 条 目 默 认 会 自动 换行 。 请 看 图 10-5。 图 中 有 两 个 集合 视图 ， 它 们 都 可 以 水 平 滚动 。 顶 部 截图 里 只 有 1 个 区 段 ， 区 段 内 有 100 个 条 目 ， 而 底部 
截图 里 则 有 100 个 区 段 ， 每 个 区 段 内 只 有 1 个 条 目 。 
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图 10-5 ”顶部 截图 : 集合 视图 内 只 有 1 个 区 段 ， 其 中 有 100 个 条 目 。 底 部 截图 : 集合 视图 内 有 100 个 区 段 ， 每 个 区 段 内 只 有 1 个 条 目 


对 于 顶部 截图 中 的 情况 来 况 ， 我 们 也 可 以 给 区 段 左右 添加 大 量 的 留 日 ， 据 使 区 段 内 的 条 目 不 要 折 行 ， 但 这 样 很 难 实现 出 正确 的 效果 ， 因 为 添加 的 间 隅 大 小 要 取决 
于 设备 及 屏幕 方向。 而 给 每 个 区 段 只 安排 一 个 条 目 ， 则 要 简单 得 多 ， 因 为 无 论 条 目的 尺寸 是 多 少 ， 我 们 总 能 将 其 排 成 一 行 。 


解决 方案 10-3 把 这 个 水 平 滚动 列表 创建 成 了 独立 的 视图 ， 而 不 是 视图 控制 器 。 这 样 做 开发 者 可 以 将 其 作为 子 视图 启 入 其 他 视图 之 中 ， 从 而 避免 屏幕 底 部 出 现 大 块 
空白 (如 图 10-5 底 部 截图 所 示 ) . 


解决 方案 10-3 "水平 滚动 的 集合 视图 


@interface InsetCollectionView : UIView 
«UICollectionViewDataSource» 


@property (strong, readonly) UICollectionView *collectionView; 
@end 


@implementation InsetCollectionView 
// 100 sections of 1 item each 
- (NSInteger)numberOfSectionsInCollectionView: 


(UICollectionView *)collectionView 


return 100; 


- (NSInteger)collectionView: (UICollectionView *)collectionView 
numberOfltemsInSection: (NSInteger)section 


return i; 


// This is a little utility that returns a view showing the 
// section and item numbers for an index path 
- (UIImageView *)viewForIndexPath: (NSIndexPath *) indexPath 
{ 
NSString *string = [NSString stringWithFormat : 
@"S%¢d(%d)", indexPath.section, indexPath.item] ; 
UIImage *image = blockStringImage(string, 16.0f); 
UIImageView *imageView = 
[[UIImageView alloc] initWithImage:image] ; 
return imageView; 


// Return an initialized cell 
- (UICollectionViewCell *)collectionView: 
(UICollectionView *) collectionView 
cellForItemAtIndexPath: (NSIndexPath *)indexPath 


UICollectionViewCell *cell = [self.collectionView 
dequeueReusableCellWithReuseIdentifier:G"cell" 
forIndexPath:indexPath]; 


cell.backgroundColor = [UIColor whiteColor]; 
cell.selectedBackgroundView - 

[[UIView alloc] initWithFrame:CGRectZero]; 
cell.selectedBackgroundView.backgroundColor - 

[[UIColor blackColor] colorWithAlphaComponent:0.5f]; 


// Show the section and item in a custom subview 
if ([cell viewWithTag:999]) 

[[cell viewWithTag:999] removeFromSuperview]; 
UIImageView *imageView = [self viewForIndexPath:indexPath] ; 
imageView.tag = 999; 

[cell.contentView addSubview: imageView] ; 


return cell; 


#pragma mark Setup 
- (instancetype) initWithFrame: (CGRect) frame 
{ 

self = [super initWithFrame:frame] ; 

if (self) 


{ 


UICollectionViewFlowLayout *layout = 


[[UICollectionViewFlowLayout alloc] init]; 
layout.scrollDirection - 

UICollectionViewScrollDirectionHorizontal; 
layout.sectionInset - 

UIEdgeInsetsMake(40.0f, 10.0f, 40.0f, 10.0£); 
layout.minimumLineSpacing - 10.0f; 
layout.minimumInteritemSpacing = 10.0f; 
layout.itemSize = CGSizeMake(100.0f, 100.0f); 


_collectionView = [[UICollectionView alloc] 
initWithFrame:CGRectZero collectionViewLayout:layout]; 
_collectionView.backgroundColor = [UIColor darkGrayColor] ; 
_collectionView.allowsMultipleSelection = YES; 
_collectionView.dataSource = self; 


[ collectionView registerClass: [UICollectionViewCell 
class] forCellWithReuseIdentifier:G"cell"]; 


[self addSubview: collectionView]; 


PREPCONSTRAINTS( collectionView); 
CONSTRAIN(self,  collectionView, 
@"H:|[_collectionView(>=0)] |") ; 
CONSTRAIN (self, _collectionView, 
@"V:|-20-[ collectionView(>=0)]-20-|"); 
| 
return self;] 


@end 


这 条 解决 方案 中 的 InsetCollectionView 类 提供 了 它 自己 的 数据 源 ， 并 把 集合 视图 作为 一 项 只 读 属性 公布 出 来 ， 令 客户 端 能 够 提供 相关 的 委托 。 图 10- 6 演示 了 这 条 
解决 方案 的 效果 ， 它 能 够 制作 出 一 张 嵌入 式 的 水 平 滚动 列表 


四 Em mmt 


图 10-6 AA 3810-348] eT FP YT HEN EAGLE P 85 2E EE BHL] 


本 章 稍 后 的 解决 方案 10-8 将 会 提供 一 种 能 够 完全 定制 的 UICollectionView-FlowLayout 子 类 ， 它 能 够 提供 真正 的 网 格 状 布局 。 而 解决 方案 10-3 则 提供 了 一 种 可 以 
直接 使 用 默认 流 式 布局 的 便捷 方案 。 此 外 ， 它 还 演示 了 在 不 使 用 内 置 控制 器 的 环境 下 ， 应 该 如 何 创建 集合 视图 。 


10.7 ”解决 万 案 : 创建 交互 式 的 布局 效果 


流 式 布局 是 完全 可 控 的 。 我 们 可 以 从 UlCollectionViewFlowLayout 中 继承 子 类 ， 以 便 实 时 地 控制 每 个 条 目的 尺寸 及 其 在 屏幕 上 的 摆 放 地 点 。 而 这 对 于 开发 者 来 
说 ， 是 个 相当 强大 的 功能 ， 它 使 得 我 们 可 以 非常 精准 地 指定 每 个 条 目的 位 置 ， 从 而 模拟 出 三 维 布局 效果 ， 并 且 使 我 们 能 够 突破 线性 模式 ， 把 行列 形式 转变 成 圆圈 、 堆 
SB.  DISEZRBHZE SJ TU. 


可 以 定制 的 布局 属性 包括 标准 的 布局 元 素 (frame, center, size) 、 透 明度 (alpha 和 hidden) 、z 轴 位 置 (zlndex) ， 以 及 坐标 变换 方式 (transform3d) 。 
当 布 局 对 象 查询 这 些 属 性 的 时 候 ， 我 们 可 以 像 解决 方案 10-4 那 样 给 出 调整 后 的 值 。 


解决 方案 10-4 ”交互 式 的 布局 效果 


@interface PunchedLayout : UICollectionViewFlowLayout 
@end 
@implementation PunchedLayout 

CGSize boundsSize; 

CGFloat midX; 


// Allow the presentation to resize as needed 
- (BOOL)shouldInvalidateLayoutForBoundsChange: (CGRect)bounds 


| 


return YES; 


// Calculate the distance from the view center 

- (void)prepareLayout 

| 
[super prepareLayout]; 
boundsSize - self.collectionView.bounds.size; 
midX - boundsSize.width / 2.0f; 


// Lay out elements 

- (NSArray *) layoutAttributesForElementsInRect: (CGRect) rect 
// Retrieve the default layout 
NSArray *array = [super layoutAttributesForElementsInRect:rect] ; 
for (UICollectionViewLayoutAttributes* attributes in array) 


| 


attributes.transform3D - CATransform3DIdentity; 
// Only handle layouts for visible items 
if (!CGRectIntersectsRect (attributes.frame, rect)) continue; 


CGPoint contentOffset - self.collectionView.contentOffset; 
CGPoint itemCenter - CGPointMake( 
attributes.center.x - contentOffset.x, 
attributes.center.y - contentOffset.y); 
CGFloat distance - ABS(midX - itemCenter.x); 


// Normalize the distance and calculate the zoom factor 
CGFloat normalized - distance / midX; 
normalized - MIN(1.0f, normalized); 
CGFloat zoom - cos(normalized * M PI 4); 
// Set the transform 
attributes.transform3D - 
CATransform3DMakeScale(zoom, zoom, 1.0f); 


| 


return array; 


| 


@end 
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目 距离 屏幕 的 水 平 中 心 有 多 远 ， 然 后 根据 余弦 函数 来 决定 缩放 倍数 (这 样 做 的 效果 是 : BaP iin, Sasa) 。 


图 10-7 演 示 了 上 述 效 果 ， 不 过 读者 最 好 能 够 目 己 运 行 解决 方案 10-4， 看 一 看 各 条 目的 尺寸 实际 改变 了 多 人 少 。 


图 10-7 由 解决 方案 10-4 所 定制 的 布局 对 和 象 ， 会 依照 每 个 条 目 与 屏幕 水 平 中 心 之 间 的 距离 来 缩放 它们 


10.8 解决 方案 : 浴 动 之 后 自动 调整 位 置 
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解决 方案 10-4 使 得 用 户 能 够 更 加 天 注 位 于 屏幕 中 心 的 条 目 。 那 么 ， 我 们 不 妨 把 屏幕 中 心 的 物件 自动 调整 到 最 合适 的 位 置 上 。 我 们 可 以 实现 一 个 用 于 布局 的 方法 ， 
把 集合 视图 的 内 容 调整 到 特定 的 边界 处 。 解 决 方案 10-5 演 示 了 具体 做 法 。 


解决 方案 10-5 ”定制 targetContentOffsetForProposedContentOffset 方 法 


- (CGPoint)targetContentOffsetForProposedContentOffset: 
(CGPoint)proposedContentOffset 
withScrollingVelocity: (CGPoint)velocity 


CGFloat offsetAdjustment - CGFLOAT MAX; 


// Retrieve all onscreen items at the proposed starting point 
CGRect targetRect = CGRectMake (proposedContentOffset.x, 0.0, 
boundsSize.width, boundsSize.height); 
NSArray *array - 
[super layoutAttributesForElementsInRect:targetRect]; 


// Determine the proposed center x-coordinate 
CGFloat proposedCenterX = proposedContentOffset.x + midX; 


// Search for the minimum offset adjustment 
for (UICollectionViewLayoutAttributes* layoutAttributes in array) 
| 
CGFloat distance - 
layoutAttributes.center.x - proposedCenterX; 
if (ABS(distance) « ABS(offsetAdjustment)) 
offsetAdjustment - distance; 


CGPoint desiredPoint - 
CGPointMake (proposedContentOffset.x « offsetAdjustment, 
proposedContentOffset.y); 


// Workaround for edge conditions. Hat tip, Nicolas Goles. 
if ((proposedContentOffset.x == 0) || 
(proposedContentOffset.x »- 
(self.collectionViewContentSize.width - 
boundsSize.width))) 


NSNotification *note - [NSNotification 
notificationWithName:@"PleaseRecenter" object: 
[NSValue valueWithCGPoint:desiredPoint]]; 
// Notify view controller of modified desired point 
[[NSNotificationCenter defaultCenter] 
postNotification:note]; 
return proposedContentOffset; 


// Offset the content by the minimal amount necessary to center 
return desiredPoint; 


用 户 在 滚动 集合 视图 时 ， 系 统 会 调用 名 为 targetContentOffsetForProposed-ContentOffset: 的 方法 ， 该 方法 描述 了 在 不 加 和 人工 干预 的 前 提 下 集合 视图 会 滚动 
到 何 处 。 履 写 该 方法 的 时 候 ， 我 们 遍历 屏幕 上 的 所 有 物件 ， 找 到 距离 视图 水 平 中 心 最 近 的 那个 ， 然 后 调整 该 方法 所 要 返回 的 偏 移 量 ， 令 该 物件 的 中 心 与 视图 的 中 心 相 
HEA. 


10.9 解决 方案 : 创建 圆 形 布局 


圆 形 布局 是 一 种 醒目 的 排版 方式 ， 它 会 将 视图 里 的 内 容 围 绕 着 某 个 中 心 区 域 来 排 布 ， 如 图 10-8 所 示 。 解 决 方案 10-6 在 很 大 程度 上 参照 了 苹果 公司 的 范例 代码 ， 那 
段 范 例 代码 是 在 2012 年 的 NWDC 上 面 首次 公布 的 。 这 种 布局 方式 很 好 地 演示 了 如 何在 创建 条 目 和 删除 条 目的 时 候 ， 把 操作 过 程 以 动画 形式 展现 出 来 。 


图 10-8 这 种 圆 形 的 布局 方式 借鉴 了 革 果 公司 的 范例 代码 ， 开 发 者 Greg Hartstein 对 此 亦 有 贡献 


解决 方案 10-6 所 采用 的 布局 对 象 ， 通 过 collectionViewContentsize 方 法 把 视图 内 容 的 尺寸 设 为 固定 值 。 由 于 它 明 确 地 创建 了 一 块 固定 不 变 的 排版 区 域 ， 所 以 集合 
视图 不 会 再 滚动 了 。 学 例 代 码 还 会 在 prepareLayout 方 法 中 进行 计算 ， 以 便 进一步 向 内 缩小 排版 区 域 。 屏 幕 高 度 与 屏幕 宽度 之 中 较 小 的 值 ， 决 定 了 圆 的 半径 。 无 论 屏 幕 
方向 如 何 改变 ， 圆 的 半径 总 保持 不 变 。 


解决 方案 10-6 ”将 集合 视图 中 的 各 条 目 排列 成 圆 形 


@implementation CircleLayout 
NSInteger numberOfItems; 
CGPoint centerPoint; 
CGFloat radius; 


NSMutableArray *insertedIndexPaths; 
NSMutableArray *deletedIndexPaths; 


// Calculate and save off the current state 
- (void)prepareLayout 
{ 
[super prepareLayout] ; 
CGSize size = self.collectionView.frame.size; 
numberOfItems = 
[self .collectionView numberOfItemsInSection:0]; 
centerPoint = 
CGPointMake(size.width / 2.0f, size.height / 2.0f); 
radius - MIN(size.width, size.height) / 3.0f; 
insertedIndexPaths - [NSMutableArray array]; 
deletedIndexPaths - [NSMutableArray array]; 


// Fix the content size to the frame size 
- (CGSize)collectionViewContentSize 


| 


return self.collectionView.frame.size; 


// Calculate position for each item 
- (UICollectionViewLayoutAttributes *) 
layoutAttributesForItemAtIndexPath: (NSIndexPath *)path 


UICollectionViewLayoutAttributes *attributes - 

[UICollectionViewLayoutAttributes 
layoutAttributesForCellWithIndexPath:path]; 

CGFloat progress - (float) path.item / (float) numberOfItems; 

CGFloat theta = 2.0f * M PI * progress; 

CGFloat xPosition = centerPoint.x + radius * cos(theta); 

CGFloat yPosition = centerPoint.y + radius * sin(theta); 

attributes.size - [self itemSize]; 

attributes.center = CGPointMake (xPosition, yPosition); 

return attributes; 


// Calculate layouts for all items 
- (NSArray *)layoutAttributesForElementsInRect: (CGRect)rect 
( 
NSMutableArray *attributes - [NSMutableArray array]; 
for (NSInteger index = 0; index < numberOfItems; index++) 
{ 
NSIndexPath *indexPath = 
[NSIndexPath indexPathForItem:index inSection:0]; 
[attributes addObject: 
[Self layoutAttributesForItemAtIndexPath: indexPath] ] ; 


} 


return attributes; 


// Build insertion and deletion collections from updates 
- (void) prepareForCollectionViewUpdates: (NSArray *)updates 


{ 


[super prepareForCollectionViewUpdates:updates] ; 


for (UICollectionViewUpdateItem* updateItem in updates) 
{ 
if (updateItem.updateAction == 
UICollectionUpdateActionInsert) 
[insertedIndexPaths 
addObject:updateItem.indexPathAfterUpdate]; 
else if (updateItem.updateAction -- 
UICollectionUpdateActionDelete) 
[deletedIndexPaths 
addObject:updateItem.indexPathBeforeUpdate]; 


// Establish starting attributes for added item 
- (UICollectionViewLayoutAttributes *) 
insertionAttributesForItemAtIndexPath: (NSIndexPath *)itemIndexPath 


UICollectionViewLayoutAttributes *attributes - 
[self layoutAttributesForItemAtIndexPath:itemIndexPath]; 
attributes.alpha = 0.0; 
attributes.center - centerPoint; 
return attributes; 


// Establish final attributes for deleted item 
- (UICollectionViewLayoutAttributes *) 
deletionAttributesForItemAtIndexPath: (NSIndexPath *)itemIndexPath 


UICollectionViewLayoutAttributes *attributes = 
[self layoutAttributesForItemAtIndexPath:itemIndexPath] ; 
attributes.alpha = 0.0; 


attributes.center - centerPoint; 
attributes.transform3D - CATransform3DMakeScale(0.1, 0.1, 1.0); 


return attributes; 


// Handle insertion animation for all items 
- (UICollectionViewLayoutAttributes*) 
initialLayoutAttributesForAppearingItemAtIndexPath: 
(NSIndexPath*)indexPath 


return [insertedIndexPaths containsObject:indexPath] ? 
[self insertionAttributesForItemAt IndexPath: indexPath] 
[super initialLayoutAttributesForAppearingItemAtIndexPath: 
indexPath] ; 


// Handle deletion animation for all items 
- (UICollectionViewLayoutAttributes*) 
finalLayoutAttributesForDisappearingItemAtIndexPath: 
(NSIndexPath*)indexPath 


return [deletedIndexPaths containsObject:indexPath] ? 
[self deletionAttributesForItemAtIndexPath:indexPath] 
[super finalLayoutAttributesForDisappearingItemAtIndexPath: 
indexPath] ; 


| 


@end 


布局 对 象 会 根据 每 个 条 目的 索引 路 径 来 计算 它 的 位 置 。 本 例 所 采用 的 布局 方式 只 使 用 一 个 区 段 ， 每 个 条 目 在 该 区 段 内 的 顺序 (比方 说 ， 它 是 第 三 个 条 目 还 是 第 五 
SRA) 决定 了 它 在 圆周 上 的 位 置 : 


CGFloat progress = (float) path.item / (float) numberOfItems; 
CGFloat theta - 2.0f * M PI * progress; 


上 述 计算 方式 也 适用 于 其 他 图 形 或 其 他 形式 的 索引 路 径 ， 只 要 各 条 目 在 系 引 路 径 中 的 位 置 都 能 调整 到 [0.0，1.0] 这 个 范围 内 融 行 。 对 于 圆 形 来 说 ， 此 学 围 可 以 和 从 
0 至 2n 的 弧度 对 应 起 来 。 而 对 于 螺旋 形 的 布局 来 说 ， 此 范围 则 可 以 和 从 0 到 3r、4nt 乃 至 5Tt 的 弧度 对 应 起 来 。 如 果 想 按照 贝 塞 尔 曲 线 来 布局 ， 那 么 开发 者 需要 遍历 能 
决定 曲线 形状 的 各 个 控制 点 ， 并 且 要 根据 情况 在 其 中 插入 其 他 的 点 。 


10.9.1 实现 创建 条 目 与 删除 条 目 时 的 动画 效果 


在 解决 万 案 10-6 里 面 有 几 个 方法 值得 关注 ， 它 们 分 别 指定 了 新 搬入 的 条 目 所 应 具备 的 初始 属性 ， 以 及 刚 删 除 的 条 目 所 应 具备 的 最 后 属性 。 这 些 属性 使 得 集合 视 医 
在 添加 新 条 目 及 删除 现 有 条 目的 时 候 ， 能 够 以 动画 效果 来 表示 该 操作 执行 前 后 的 布局 变化 过 程 。 


本 条 解决 方案 的 动画 效果 与 苹果 公司 的 原始 范例 代码 一 样 : 新 添加 的 条 目 一 开始 会 以 全 透明 的 形态 出 现在 圆圈 正中 ， 然 后 会 移动 到 它 应 有 的 位 置 上 ， 在 移动 过 程 
中 它 将 逐渐 淡 入 。 而 刚 删 除 的 条 目 则 会 从 目前 的 位 置 移 向 圆心 ， 并 在 此 过 程 中 逐渐 缩小 、 淡 出 。 运 行 范 例 代码 的 时 候 束 能 看 到 这 些 效果 了 。 


开发 文档 中 的 initialLayoutAttributesForAppearingltemAtlndexPath 及 finalLayoutAttributesForDisappearingltemAtlndexPath 方 法 ， 名 字 起 得 很 令 人 困惑 ， 
从 表面 上 看 ， 这 些 方法 似乎 只 会 针对 刚 插入 或 删除 的 条 目 来 调用 。 但 实际 上 ， 系 统 会 向 每 一 个 条 目 询 问 它 的 起 始 属性 (starting attribute) 和 最 终 属 性 (ending 
attribute) ， 而 不 仅仅 向 刚 添加 或 删除 的 条 目 询 问 。 所 以 ， 解 决 方案 10-6 在 添加 条 目 和 删除 条 目的 时 候 ， 会 把 所 添 条 目 及 所 删 条 目的 索引 路 径 分 别 记 录 到 两 个 数组 里 
面 。 这 样 的 话 ， 我 们 就 可 以 只 针对 当前 要 添加 或 删除 的 条 目 来 定制 其 属性 了 。 

该 机 制 所 提供 的 这 种 方式 ， 能 够 把 视图 中 全 部 条 目的 布局 属性 都 以 动画 形式 表现 出 来 ， 使 得 开 上 友 者 可 以 按照 需要 添加 额外 的 动画 效果 。 比 方 说 ， 如 果 有 新 的 条 目 
插入 第 3 行 ， 那 么 该 行 末 尾 的 条 目 融 应 该 移动 到 第 4 行 开 头 。 在 默认 的 情况 下 ， 末 尾 的 条 目 会 按照 斜 线 方向 移动 到 下 一 行 开头 ， 但 有 了 这 套 方 式 之 后 ， 我 们 融 可 以 把 第 3 
行 末尾 的 单元 格 先 向 右 移 出 屏幕 ， 然 后 再 将 其 从 第 4 行 左 侧 移入 屏幕 。 


10.9.2 ”增强 圆 形 布局 的 实用 性 


本 条 解决 方案 对 苹果 公司 原 有 的 范例 代码 做 了 几 处 修改 。 其 中 之 一 束 是 : 解决 方案 10-6 使 用 了 导航 栏 上 的 Add 及 Delete 按 钮 ， 而 没有 使 用 手势 。 另 外 一 处 修改 
是 : 我 们 把 每 个 小 视图 都 设 为 不 同 颜色 ， 从 而 令 用 户 可 以 把 它们 区 分 开 。 解 决 方案 10-6 提 供 了 选择 功能 。 用 户 可 以 选 定 某 个 条 目 。 然 后 可 以 把 该 条 目 删 掉 ， 也 可 以 把 
新 的 条 目 添加 到 它 后 面 。 


下 面 这 段 删 除 代码 会 找到 当前 选 定 的 条 目 将 其 删除 ， 并 选中 下 一 个 条 目 。 然 后 ， 它 会 根据 屏幕 上 面 现 有 的 条 目 数 量 来 局 用 或 禁用 Add 及 Delete 按 钮 : 


- (void)delete 


| 


if (!count) return; 


// Decrement the number of onscreen items 
count --; 


// Determine which item to delete 
NSArray *selectedItems - 
[self.collectionView indexPathsForSelectedItems]; 
NSInteger itemNumber - selectedItems.count ? 
((NSIndexPath *)selectedItems[(0]).item : 0; 


NSIndexPath *itemPath - 
[NSIndexPath indexPathForItem:itemNumber inSection:0]; 


// Perform deletion 

[self.collectionView performBatchUpdates:^( 
[self.collectionView deleteItemsAtIndexPaths:@[itemPath] ] ; 

) completion:^(BOOL done) { 


if (count) 
[self.collectionView selectItemAtIndexPath: 
[NSIndexPath indexPathForItem: 

MAX(0, itemNumber - 1) inSection:0] 
animated:NO 
scrollPosition:UICollectionViewScrollPositionNone]; 

self.navigationlItem.rightBarButtonItem.enabled = 
(count » 0); 

self .navigationItem.leftBarButtonItem.enabled = 
(count < (IS IPAD ? 20 : 8)); 


)1; 


在 真实 的 应 用 程序 中 ， 很 少 需要 添加 或 删除 一 些 役 此 之 间 没 有 区 别 的 视图 ， 不 过 ， 有 的 时 候 却 需要 添加 或 删除 一 些 含 义 各 不 相同 的 视图 。 因 此 ， 本 例 所 做 的 改动 
使 得 这 个 范例 变 得 更 加 实用 了 ， 读 者 可 以 以 此 为 起 点 ， 根 据 应 用 程序 的 实际 需要 来 扩充 这 条 解决 方案 。 


10.9.3 MDNR 


图 10-8 演 示 了 由 解决 方案 10-6 所 构建 的 布局 效果 。 当 用 户 添 加 一 些 新 条 目 进 来 之 后 ， 圆 周 上 的 条 目 变 得 拥挤 了 ， 在 iPad 上 面 最 多 可 以 有 20 个 条 目 ， 而 在 iPhone 上 
面 最 多 则 可 以 有 8 个 条 目 。 读 者 很 容易 在 add 及 delete 方 法 中 修改 这 些 上 限 值 ， 使 其 与 目 己 的 应 用 程序 相符 。 


10.10 ”解决 方案 : 用 手势 调整 布局 


解决 方案 10-7 是 基于 解决 方案 10-6 而 构建 的 ， 它 添加 了 交互 性 的 手势 功能 ， 使 得 用 尸 可 以 通过 手势 来 调整 布局 。 该 解决 方案 使 用 了 两 个 手势 识别 器 : 一 个 识别 双 


指 缩放 (pinch) 手势 ， 另 一 个 识别 旋转 (rotate) 手势 。 视 图 中 的 条 目 可 以 同时 识别 这 两 种 手势 ， 所 以 用 户 可 以 同时 对 其 进行 缩放 与 旋转 。 


解决 方案 10-7 ”使 用 户 可 以 通过 手 为 来 调整 集合 视图 的 布局 


// Intermediate rotation 
- (void)rotateBy: (CGFloat)theta 


| 


currentRotation = theta; 


// Final rotation 

- (void)rotateTo: (CGFloat)theta 
rotation += theta; 
currentRotation = 0.0f; 


// Scaling 
- (void)scaleTo: (CGFloat)factor 


| 


scale = factor; 


// Calculate position for each item 
- (UICollectionViewLayoutAttributes *) 
layoutAttributesForItemAtIndexPath: (NSIndexPath *)path 


UICollectionViewLayoutAttributes *attributes - 
[UICollectionViewLayoutAttributes 
layoutAttributesForCellWithIndexPath:path]; 
CGFloat progress - (float) path.item / (float) numberOfItems; 
CGFloat theta = 2.0f * M PI * progress; 


// Update the scaling and rotation to match the current gesture 
CGFloat scaledRadius - MIN(MAX(scale, 0.5f), 1.3f) * radius; 
CGFloat rotatedTheta = theta + rotation + currentRotation; 
// Calculate the new positions 
CGFloat xPosition - 

centerPoint.x + scaledRadius * cos(rotatedTheta); 
CGFloat yPosition - 

centerPoint.y + scaledRadius * sin(rotatedTheta); 
attributes.size - [self itemSize]; 
attributes.center - CGPointMake(xPosition, yPosition); 
return attributes; 


| 


@end 


处 理 旋转 手势 要 比 处 理 双 指 缩放 手势 稍微 复杂 一 点 。 双 指 缩放 手势 会 直接 给 出 当前 的 缩放 倍数 ， 而 旋转 手势 给 出 的 则 是 当前 角度 与 尚未 开始 旋转 时 的 角度 差 。 由 
于 它 给 出 的 不 是 相 邻 两 次 旋转 手势 之 间 的 差 值 ， 所 以 在 持续 执行 旋转 手势 时 ， 我 们 要 根据 当前 角度 与 旋转 之 前 的 角度 差 来 进行 旋转 。 于 是 ， 解 决 方 案 10-7 会 在 回调 方 
法 中 分 别处 理 两 种 状况 。 如 果 旋 转 操作 正在 持续 进行 ， 那 就 根据 这 次 旋转 的 量 来 更 新 当前 的 旋转 角度 [1]; 如 果 旋 转 操作 即将 结束 ， 那 就 把 当前 的 旋转 角度 置 为 0， 这 样 
的 话 ， 下 次 旋转 时 就 能 从 新 的 基准 值 轴 开始 计算 了 : 


- (void)pinch: (UIPinchGestureRecognizer *)pinchRecognizer 


CircleLayout *layout - 

(CircleLayout *)self.collectionView.collectionViewLayout; 
[layout scaleTo:pinchRecognizer.scale] ; 
[layout invalidateLayout] ; 


- (void) rotate: (UIRotationGestureRecognizer *)rotationRecognizer 


CircleLayout *layout = 
(CircleLayout *)self.collectionView.collectionViewLayout; 


if (rotationRecognizer.state == UIGestureRecognizerStateEnded) 
[layout rotateTo:rotationRecognizer.rotation]; 

else 
[layout rotateBy: rotationRecognizer.rotation] ; 

[layout invalidateLayout] ; 


请 注意 ， 上 面 两 个 方法 都 会 调用 invalidateLayout， 以 迫使 布局 对 象 实时 更 新 视图 的 布局 。 由 于 这 条 解决 方案 要 进行 大 量 的 图 形 计算 ， 所 以 最 好 是 在 真 机 上 面 进 行 
测试 。 


解决 方案 10-7 会 根据 用 户 的 手势 来 调整 视图 内 容 的 半径 (最 小 可 以 缩小 到 原来 的 一 半 ， 最 大 可 以 放大 到 原来 的 1.3 倍 ) 和 起 始 角 (start angle) ， 以 便 修 改 布局 效 
果 。 起 始 角 的 初始 值 是 0 度 ， 但 每 次 执行 完 旋转 操作 之 后 ， 它 的 值 都 会 更 新 。 程 序 会 根据 缩放 后 的 半径 以 及 调整 后 的 角度 来 重新 排 布 集合 视图 。 


[1] 相当 于 CircleLayout 中 的 currentRotation 变 量 。 译 者 注 


[2] 相当 于 CircleLayout 中 的 rotation 变 量 ， 也 就 后 文 所 说 的 “起 始 角 ”。 


译 者 注 


10.11 解决 万 案 : 创建 真正 的 网 格 状 布局 


默认 的 流 式 布局 会 自动 换行 ， 以 便 使 区 段 中 的 条 目 能 够 适应 集合 视图 的 长 度 或 宽度 ， 但 这 样 做 出 来 的 视图 只 能 在 一 个 方向 上 滚动 。 如 果 愿 意 多 做 一 些 数学 运算 ， 
束 可 以 编写 自 定 义 的 布局 子 类 ， 从 而 实现 不 会 换行 的 双向 滚动 视图 。 实 现 该 功能 所 需 的 运算 量 比较 大 ， 而 且 不 是 特别 容易 。 图 10-9 演 示 了 这 种 布局 。 
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图 10-9 上 自 定义 的 网 格 状 布局 ， 使 得 用 户 能 够 在 水 平方 向 和 垂直 方向 上 滚动 集合 视图 


解决 方案 10-8 完 全 定制 了 UlCollectionViewFlowLayout 的 子 类 ， 履 写 了 collection-ViewContentSize 及 layoutAttributesForltemAtlndexPath : 方法 ， 以 便 手 
工 摆 放 每 个 条 目 。 这 种 实现 方式 完全 考虑 到 所 有 与 间隔 有 关 的 请 求 以 及 回调 方法 。 相 比 之 下 ， 普 通 的 流 式 布局 只 会 在 满足 多 个 最 小 值 的 前 提 下 ， 试 着 把 条 目 合 适 地 授 
放 到 屏幕 中 。 而 我 们 的 布局 子 类 ， 则 会 根据 这 些 限定 值 ， 精 确 地 调整 视图 底层 的 内 容 大 小 ， 令 其 与 开 友 者 所 指定 的 尺寸 完全 匹配 。 


解决 方案 10-8 ”自己 编写 网 格 状 的 布局 类 


@implementation GridLayout 


#pragma mark Items 
// Does a delegate provide individual sizing? 
- (BOOL)usesIndividualltemSizing 
| 
return [self.collectionView.delegate respondsToSelector: 
Gselector(collectionView:layout:sizeForItemAtIndexPath:)]; 


// Return cell size for an item 
- (CGSize)sizeForItemAtIndexPath: (NSIndexPath *)indexPath 
CGSize itemSize = self.itemSize; 
if ([self usesIndividualltemSizing]) 
itemSize = [(id <UICollectionViewDelegateFlowLayout >) 
self.collectionView.delegate 
collectionView:self.collectionView 
layout:self sizeForItemAtIndexPath: indexPath] ; 
return itemSize; 
| 
#pragma mark Insets 
// Individual insets? 
- (BOOL)usesIndividualInsets 
| 
return [self.collectionView.delegate respondsToSelector: 
Gselector(collectionView:layout:insetForSectionAtIndex:)]; 


// Return insets for section 
- (UIEdgeInsets) insetsForSection: (NSInteger) section 
{ 
UIEdgeInsets insets = self.sectionInset; 
if ([self usesIndividualInsets]) 
insets - [(id «UICollectionViewDelegateFlowLayout») 
self.collectionView.delegate 
collectionView:self.collectionView 
layout:self insetForSectionAtIndex:section]; 
return insets; 


#pragma mark Item Spacing 
// Individual item spacing? 
- (BOOL)usesIndividualltemSpacing 
( 
return [self.collectionView.delegate respondsToSelector: 
@selector(collectionView: layout: 
minimumInteritemSpacingForSectionAtIndex:)]; 


// Return spacing for section 
- (CGFloat)itemSpacingForSection: (NSInteger)section 
{ 
CGFloat spacing = self.minimumInteritemSpacing; 
if ([self usesIndividualItemSpacing] ) 
spacing = [(id <UICollectionViewDelegateFlowLayout >) 
self.collectionView.delegate 
collectionView:self.collectionView 
layout:self 
minimumInteritemSpacingForSectionAtIndex:section]; 
return spacing; 


#pragma mark Layout Geometry 
// Find the tallest subview 
- (CGFloat)maxItemHeightForSection: (NSInteger)section 
{ 
CGFloat maxHeight = 0.0f; 
NSInteger numberOfItems = 
[self.collectionView numberOfItemsInSection:section] ; 
for (int i = 0; i « numberOfItems; i++) 
{ 
NSIndexPath *indexPath = INDEXPATH(section, i); 
CGSize itemSize = [self sizeForItemAtIndexPath:indexPath] ; 
maxHeight = MAX(maxHeight, itemSize.height) ; 


} 


return maxHeight ; 


// “Horizontal" row-based extent from the start of the section to its end 
- (CGFloat) fullWidthForSection: (NSInteger) section 

UIEdgeInsets insets = [self insetsForSection:section] ; 

CGFloat horizontalInsetExtent = insets.left + insets.right; 

CGFloat collectiveWidth = horizontalInsetExtent; 


NSInteger numberOfItems 
[self.collectionView numberOfItemsInSection:section]; 

for (int i = 0; i < numberOfItems; i++) 
NSIndexPath *indexPath = INDEXPATH(section, i); 
CGSize itemSize = [self sizeForItemAtIndexPath:indexPath] ; 


collectiveWidth «- itemSize.width; 
collectiveWidth += [self itemSpacingForSection:section]; 


// Take back one spacer, n-1 fence post 
collectiveWidth -- [self itemSpacingForSection:section]; 


return collectiveWidth; 


// Bounding size for each section 
- (CGSize)fullSizeForSection: (NSInteger)section 
{ 

CGFloat headerExtent = (self.scrollDirection == 
UICollectionViewScrollDirectionHorizontal) ? 
self .headerReferenceSize.width 
self .headerReferenceSize.height; 

CGFloat footerExtent = (self.scrollDirection == 
UICollectionViewScrollDirectionHorizontal) ? 
self .footerReferenceSize.width 
self .footerReferenceSize.height; 


UIEdgeInsets insets = [self insetsForSection:section] ; 
CGFloat verticalInsetExtent = insets.top + insets.bottom; 
CGFloat maxHeight = [self maxItemHeightForSection:section] ; 


CGFloat fullHeight = headerExtent + footerExtent + 
verticallnsetExtent + maxHeight; 
CGFloat fullWidth = [self fullWidthForSection:section]; 


return CGSizeMake(fullWidth, fullHeight); 


// How far is each item offset within the section 
- (CGFloat) horizontalInsetForItemAtIndexPath: (NSIndexPath *) indexPath 
{ 
UIEdgeInsets insets = [self insetsForSection:indexPath.section] ; 
CGFloat horizontalOffset = insets.left; 
for (int i = 0; i < indexPath.item; i++) 
{ 
CGSize itemSize = [self sizeForItemAtIndexPath: 
INDEXPATH (indexPath.section, i)]; 
horizontalOffset += (itemSize.width + 
[self itemSpacingForSection:indexPath.section]); 


} 


return horizontalOffset; 


// How far is each item down 
- (CGFloat)verticallnsetForlItemAtIndexPath: (NSIndexPath *)indexPath 


{ 


CGSize thisItemSize = [self sizeForItemAtIndexPath: indexPath] ; 
CGFloat verticalOffset = 0.0Of; 


// Previous sections 
for (int i = O; i < indexPath.section; i++) 
verticalOffset += [self fullSizeForSection:i].height; 


// Header 
CGFloat headerExtent = (self.scrollDirection == 
UICollectionViewScrollDirectionHorizontal) ? 
self.headerReferenceSize.width 
self.headerReferenceSize.height; 
verticalOffset += headerExtent; 


// Top inset 
UIEdgeInsets insets = [self insetsForSection:indexPath.section] ; 
verticalOffset += insets.top; 


// Vertical centering 
CGFloat maxHeight = 

[self maxItemHeightForSection: indexPath.section] ; 
CGFloat fullHeight = (maxHeight - thisItemSize.height); 
CGFloat midHeight = fullHeight / 2.0f; 


switch (self.alignment) 
{ 
case GridRowAlignmentNone: 
case GridRowAlignmentTop: 
break; 
case GridRowAlignmentCenter: 
verticalOffset += midHeight; 
break; 
case GridRowAlignmentBottom: 
verticalOffset += fullHeight; 
break; 
default: 
break; 


return verticalOffset; 


#pragma mark Layout Attributes 

// Provide per-item placement 

- (UICollectionViewLayoutAttributes *)layoutAttributesForItemAtIndexPath: 
(NSIndexPath *)indexPath 


UICollectionViewLayoutAttributes *attributes - 
[UICollectionViewLayoutAttributes 
layoutAttributesForCellWithIndexPath:indexPath]; 
CGSize thisItemSize - [self sizeForItemAtIndexPath:indexPath]; 


CGFloat verticalOffset - 

[self verticallnsetForItemAtIndexPath:indexPath]; 
CGFloat horizontalOffset - 

[self horizontalInsetForItemAtIndexPath:indexPath]; 


if (self.scrollDirection == UICollectionViewScrollDirectionVertical) 
attributes.frame - CGRectMake (horizontalOffset, 
verticalOffset, thisItemSize.width, thisItemSize.height); 
else 
attributes.frame - CGRectMake(verticalOffset, 
horizontalOffset, thisItemSize.width, 
thisItemSize.height); 


return attributes; 
// Return full extent 
- (CGSize)collectionViewContentSize 


| 


NSInteger sections - self.collectionView.numberOfSections; 


CGFloat maxWidth = 0.0f; 
CGFloat collectiveHeight = 0.0f; 


for (int i = 0; i « sections; i++) 

{ 
CGSize sectionSize = [self fullSizeForSection:i]; 
collectiveHeight += sectionSize.height; 
maxWidth = MAX(maxWidth, sectionSize.width) ; 


if (self.scrollDirection == 
UICollectionViewScrollDirectionVertical) 
return CGSizeMake (maxWidth, collectiveHeight) ; 
else 
return CGSizeMake(collectiveHeight, maxWidth); 


// Provide grid layout attributes 
- (NSArray *)layoutAttributesForElementsInRect: (CGRect)rect 
{ 
NSMutableArray *attributes = [NSMutableArray array] ; 
for (NSInteger section = 0; 
Section < self.collectionView.numberOfSections; section++) 
for (NSInteger item = 0; 
item < [self.collectionView 
numberOfItemsInSection:section] ; 
item++) 


UICollectionViewLayoutAttributes *layout = 
[self layoutAttributesForItemAtIndexPath: 
INDEXPATH(section, item)]; 


[attributes addObject:layout] ; 


| 


return attributes; 


- (BOOL) shouldInvalidateLayoutForBoundsChange: (CGRect)oldBounds 


| 


return YES; 


| 


@end 
解决 方案 10-8 中 的 布局 对 象 要 把 每 个 元 素 的 排 布 位 置 都 计算 出 来 。 但 是 它 不 会 使 用 行 间距 属性 ， 因 为 该 属性 只 在 自动 换行 的 前 提 下 才 有 意义 。 我 们 所 制作 的 网 格 
状 布局 ， 绝 不 会 自动 换行 ， 所 以 本 条 解决 方案 会 彻底 忽略 该 属性 。 


本 条 解决 方案 的 布局 对 象 里 ， 还 有 个 名 为 alignment 的 属性 。 这 个 新 属性 决定 了 表格 中 的 每 一 行 是 顶端 对 齐 、 底 端 对 齐 ， 还 是 居中 对 齐 。 它 会 查询 一 整 行 的 总 体高 
度 ， 然 后 可 能 会 把 比 这 个 高 度 矮 的 条 目 移 动 一 段 距离 。 


解决 方案 10-8 中 包含 了 这 个 子 类 的 所 有 代码 ， 读 者 可 以 看 到 : 想 实现 这 样 一 种 完全 定制 的 UICollectionViewFlowLayout 子 类 需要 编写 多 少 代码 。 编 程 技 巧 当然 还 
是 隐藏 在 细节 之 中 。 我 们 应 该 尽量 用 各 种 物件 来 彻底 地 测试 这 个 GridLayout。 
10.12 解决 方案 : ARAMA PNA AIEEE 


当 用 户 对 某 个 条 目 执行 标准 的 “长 按 ” 手势 时 ， 集 合 视图 里 面 可 以 实现 出 图 10-10 这 样 的 菜单 。 该 菜单 默认 会 提供 剪 切 、 复 制 及 粘贴 操作 。 不 过 开发 者 也 可 以 把 这 
些 操 作 换 成 自己 定义 的 其 他 操作 ， 从 而 构建 出 下 面 的 菜单 。 


Carrier 全 1:13 AM am 


Add Jouble-tap items Delete 


Pop Rotate (shost 


A10-10 ”车 想 为 每 个 条 目 实 电 义 菜单 ， 则 需 令 单 元 格 成 为 第 一 响应 者 
菜单 功能 要 通过 U1CollectionViewDelegate 协 议 中 的 下 面 三 个 方法 来 实现 : 
. collectionView: shouldShowMenuForltemAtIndexPath: 该 方法 用 来 决定 在 给 定 的 索引 路 径 处 是 否 应 该 显示 菜单 。 


- collectionView: canPerformAction: forltemAtIndexPath: withSender: 该 方法 用 来 确认 委托 是 否 能 在 位 于 索引 路 径 处 的 条 目 上 面 执行 给 定 的 操作 。 
这 个 委托 方法 可 以 用 来 去 掉 我 们 不 想 要 的 默认 操作 ， 比 如 剪 切 、 复 制 及 粘贴 。 


- collectionView: performAction: forltemAtIndexPath: withSender: 


该 方法 会 命令 委托 在 位 于 索引 路 径 处 的 条 目 上 面 执行 给 定 的 操作 。 
除了 要 在 前 两 个 万 法 里 返回 YES， 并 且 在 第 三 个 万 法 里 处 理 相关 操作 之 外 ， 我 们 还 必须 令 集合 视图 能 够 成 为 第 一 响应 者 : 


- (BOOL)canBecomeFirstResponder 


| 


return YES; 


满足 上 述 所 有 要 求 之 后 ， 当 用 户 按 住 寻 个 条 目 不 放 时 ， 集 合 视图 里 面 融会 出 现 菜单 了 。 
使 用 户 能 够 以 双击 的 方式 弹出 菜单 


由 UICollectionView 所 提供 的 菜单 ， 需 要 以 长 按 不 放 的 手势 来 激活 ， 而 解决 方案 10-9 则 创建 了 自 定 义 的 单元 格 类 ， 并 且 添 加 了 针对 双击 手势 的 识别 器 。 如 果 侦 测 
到 双击 手势 ， 那 么 回调 方法 融会 把 相关 单元 格 设 为 第 一 响应 者 ， 并 在 它 上 面 展示 出 标准 的 菜单 。 


解决 方案 10-9 ”在 集合 视图 的 单元 格 上 实现 自 定义 的 菜单 
- (BOOL)canBecomeFirstResponder 


| 


return YES; 


- (BOOL)canPerformAction: (SEL)action withSender: (id) sender 


if (action -- Gselector(ghostSelf)) return YES; 
if (action == @selector(popSelf)) return YES; 

if (action -- Gselector(rotateSelf)) return YES; 
if (action == @selector(colorize)) return YES; 
return NO; 


- (void)tapped: (UIGestureRecognizer *)uigr 


| 


if (uigr.state != UIGestureRecognizerStateRecognized) return; 


[[UIMenuController sharedMenuController] setMenuVisible:NO 
animated:YES]; 
[self becomeFirstResponder]; 


UIMenuController *menu = [UIMenuController sharedMenuController]; 
UIMenuItem *pop - [[UIMenuItem alloc] 

initWithTitle:@"Pop" action:@selector (popSelf)]j; 
UIMenuItem *rotate = [[UIMenuItem alloc] 

initWithTitle:G"Rotate" action:Gselector(rotateSelf)]; 
UIMenuItem *ghost - [[UIMenuItem alloc] 

initWithTitle:@"Ghost" action:Gselector (ghostSelf)]; 
UIMenuItem *colorize - [[UIMenuItem alloc] 

initWithTitle:@"Colorize" action:Gselector(colorize)]; 


[menu setMenuItems:G[pop, rotate, ghost, colorizel]; 


[menu update]; 
[menu setTargetRect:self.bounds inView:self]; 
[menu setMenuVisible:YES animated:YES]; 


解决 方案 10-9 列 出 了 相关 的 细节 代码 。 这 个 UICollectionViewCell 的 子 类 宣称 自己 可 以 成 为 第 一 响应 者 ， 这 是 在 它 上 面 显示 菜单 的 先决 条 件 。 该 类 设置 了 它 想 要 


显示 的 菜单 项 ， 并 实现 了 canpPerformAction: withSender: 方法 ， 使 得 这 些 菜单 项 能 够 显示 出 来 。 图 10-10 中 的 菜单 就 是 用 这 条 解决 方案 创建 出 来 的 。 


10.13 “小结 


本 章 介 绍 了 集合 视图 以 及 功能 非常 强大 的 流 式 布局 (UlCollectionViewFlowLayout) 。 读 者 学 到 了 如 何 创建 简单 的 集合 视图 控制 器 ， 以 及 如 何 创建 独立 的 视图 。 
我 们 讨论 了 怎样 设置 布局 对 象 的 关键 属性 。 此 外 ， 还 讲解 了 怎样 创建 生动 的 有 反馈 效果 ， 以 及 怎样 以 动画 形式 来 表现 插入 条 目 及 删除 条 目的 过 程 。 阅 读 下 一 草 之 前 ,请 
回顾 下 面 几 个 问题 : 


集合 视图 提供 了 许多 功能 ， 开 发 者 无 须 编 写 大 量 代码 ， 即 可 使 用 它们 。 集 合 视图 所 提供 的 API 要 比 表 格 视 图 强大 得 多 ， 这 些 功能 如 果 改 用 表格 来 实现 ， 需 要 编写 
很 多 代码 ， 而 有 全 有 些 功能 黄 至 不 太 可 能 用 表格 来 实现 。 


` 本 章 只 是 粗略 地 提 了 一 下 头 部 视图 和 尾部 视图 ， 而 且 根 本 没有 用 到 装饰 视图 。 本 章 的 范例 代码 详细 体现 了 创建 自 定义 的 补充 视图 类 时 所 应 注意 的 事项 。 


` 集合 视图 在 排 布 其 中 的 条 目 时 ， 可 以 带 有 丰富 的 变换 效果 。 我 们 可 以 试 着 在 界面 中 以 动画 来 响应 用 户 的 操作 。 但 是 ， 不 要 盲目 地 添加 动画 效果 ， 而 是 应 该 把 握 


` 本 章 通 过 指定 各 条 目 刚 添加 进来 时 的 初始 属性 ， 以 及 删除 完毕 之 后 的 最 终 属性 来 实现 添加 及 删除 时 的 动画 效果 ， 而 这 对 于 补充 视图 来 说 也 同样 适用 。 利 用 这 一 
特性 ， 我 们 可 以 用 动画 效果 来 表示 将 要 出 现在 集合 视图 里 面 的 新 区 段 ， 以 及 将 要 从 集合 视图 中 离开 的 区 段 。 


: 与 动画 效果 类 似 ， 手 势 也 应 该 设计 得 明智 一 些 。 如 果 用 户 不 太 能 够 发 现 自己 可 以 通过 长 按 或 三 连 击 手 势 来 添加 或 删除 条 目 ， 就 不 要 设计 这 样 的 手势 了 。 我 们 可 
以 改 用 弹出 式 窗口 、 菜 单 、 浮 动 的 文字 或 是 简单 的 按钮 来 告诉 用 户 应 该 如 何 管理 并 改变 视图 中 的 条 目 。 


: 研究 UICollectionViewFlowLayout 类 的 时 候 ， 不 要 单单 依赖 于 该 类 的 文档 ， 而 是 应 该 看 看 它 的 抽象 基 类 UICollectionViewLayout。 这 个 类 描述 了 开发 者 所 要 定义 的 每 


一 个 关键 方法 。 


. 最 后 要 注意 ， 我 们 应 该 在 设备 上 面 测试 应 用 程序 。 当 程序 使 用 布局 对 象 时 ， 尤 其 是 使 用 频繁 更 新 的 布局 或 带 有 变换 效果 的 布局 时 ， 它 的 性 能 就 无 法 准确 地 反映 
到 模拟 器 之 中 了 。 此 时 我 们 应 该 在 设备 上 面 进行 测试 ， 并 通过 Instruments 来 分 析 程序 的 性 能 ， 看 看 程序 的 布局 是 不 是 设计 得 太 过 复杂 。 


BE 分 译文 档 与 数据 


在 iOS 系 统 中 ， 应 用 程序 之 间 可 以 共享 信息 及 数据 ， 也 可 以 通过 许多 系统 特性 ， 把 控制 权 转 移 给 另 一 个 程序 。 每 个 程序 都 能 够 访问 系统 共用 的 问 贴 板 ， 这 使 得 不 同 
的 程序 之 间 可 以 复制 并 粘贴 数据 。 应 用 程序 可 以 请 求 系统 在 某 份 文 档 上 面 执行 由 系统 所 提供 的 一 些 操作 ， 比 方 说 打印 、 发 布 Twitter 消息 ， 或 是 张贴 到 Facebook 等 。 
应 用 程序 可 以 声明 目 定义 的 URL 方 案 ， 这 些 URL 方 案 能 够 秦 入 文档 及 网 页 乙 中 。 本 章 将 会 介绍 如 何在 应 用 程序 乙 间 分 享 文档 及 数据 。 读 者 将 会 学 到 ' 后 样 把 这 些 特 性 添加 
到 上 自己 的 应 用 程序 中 ， 以 及 怎样 巧妙 地 利用 这 些 特性 ， 来 与 iOS 系 统 中 的 其 他 程序 相互 配合 。 


11.1 解决 方案 : 使 用 统一 类 型 标识 符 


统一 类 型 标识 符 (Uniform Type Identifier, HUTI) 是 iOS 系 统 在 分 享 信 息 时 所 使 用 的 中 心 组 件 ， 可 以 将 它们 看 成 是 新 一 代 的 MIME 类 型 。UTl 是 一 种 字符 捉 ， 
能 够 表示 诸如 图 像 及 文本 等 资源 类 型 。UTI 指 明了 程序 之 间 将 要 共用 的 数据 对 象 是 何 类 型 。 它 们 并 不 依赖 于 原 有 的 各 种 指示 符 ， 比 如 文件 扩展 名 、MIME 类 型 或 是 
OSType 等 与 文件 类 型 有 关 的 元 数据 。UTI 用 一 种 更 新 颖 、 更 灵活 的 技术 取代 了 原 有 的 那些 技术 。 


UTI 的 命名 遵循 反 向 域名 样式 (reverse-domain-style) 。 由 苹果 公司 所 定义 的 那些 常用 标识 符 ， 遵 循 public.html 及 publicjpeg 这 样 的 格式 。 前 者 表示 HTML 源 
文本 ， 后 者 表示 JPEG 图 像 ， 这 两 种 UTI 都 对 应 于 特定 类 型 的 信息 。 


继承 在 UTI 中 扮演 了 重要 角色 。UTI 使 用 了 与 面向 对 象 类 似 的 继承 体系 ， 其 中 的 子 UTI 与 上 级 UTI 之 间 有 is-a (是 一 种 ) 的 关系 。 子 UTI 继 承 了 上 级 UTI 的 全 部 属性 ， 
此 外 还 添加 了 一 些 更 为 具体 的 属性 ， 用 以 体现 它 所 代表 的 特定 信息 类 型 。 之 所 以 要 这 样 设计 ， 是 因为 对 于 每 个 UTI 来 说 ， 既 有 比 它 更 通用 的 UTI， 又 有 比 它 更 具体 的 
UTI。 我 们 以 表示 JPEG 图 像 的 UTI 为 例 来 说 明 。JPEG 图 像 (publicjpeg) 是 一 种 图 像 (publicimage) ， 而 图 像 又 是 一 种 数据 (public.data) 。 数 据 是 一 种 用 户 可 以 
看 到 或 听 到 的 内 容 (public.content) ， 而 内 容 又 表示 了 一 个 条 目 (public.item) 。public.item 是 UTI 体 系 中 的 通用 基础 类 型 。 整 套 体系 叫 作 遵 循 体 系 ， 其 中 的 子 
UTI “遵循 ” 它 的 上 级 UTI。 比 方 说 ， 更 为 具体 的 jpeg 型 UTI 就 遵循 更 加 通用 的 image 型 UTI| 或 data 型 UTI。 


图 11-1 列 出 了 苹果 公司 的 基本 遵循 树 。 树 中 位 置 较 低 的 UTI， 必 须 遵 循 其 上 级 UTI 的 全 部 数据 属性 。 如 果 声 明了 某 个 上 级 UTI， 那 就 表示 要 支持 它 的 全 部 子 UTI。 比 


方 说 ， 如 果 某 程序 宣称 自己 能 够 打开 public.data 类 型 的 数据 ， 那 它 就 必须 能 处 理 文本 、 电 影 以 及 图 像 文件 等 内 容 才 行 。 


public.data 


| public. html public.plain-text , com.apple.quicktime-movie public.mpeg 


| com.mycorp.myapp.myspecialtext j 


图 11-1 苹果 公司 的 基本 遵循 树 


UTI 可 以 多 重 继承 。 某 个 条 目 可 以 遵循 不 止 一 个 上 级 UTI。 所 以 ， 我 们 可 以 宣称 它 同 时 遵循 public text 及 publicimage， 这 样 就 能 指定 一 种 既 能 容纳 文本 又 能 容纳 
图 像 的 数据 类 型 了 。 


虽说 每 个 UTI 都 应 该 遵循 命名 规 泥 ， 但 却 没有 统一 的 UTI 注 册 机 构 。 public 域 用 来 表示 iOS 专 用 的 类 型 ， 大 部 分 应 用 程序 都 可 以 共用 这 些 类 型 。 苹 果 公 司 生成 了 一 份 
由 public UTI 所 构成 的 完整 体系 图 表 。 第 三 方 厂商 专用 的 UTI， 应 该 按照 标准 的 反 向 域名 样式 来 命名 (例如 com.sadun.myCustomType 及 com.apple.quicktime- 


movie) , 


11.1.1. 根据 文件 扩展 名 来 决定 UTI 


Mobile Core Services 模 块 提供 了 一 些 工具 ， 可 以 根据 文件 扩展 名 来 获取 UTI 人 信息。 在 使 用 这 些 基于 C 语 言 的 消 数 之 前 ， 必 须 先 引入 相关 模块 。 下 面 这 个 背 数 会 根 
据 传 入 的 ext 字 符 串 参数 来 返回 首选 的 UTI。 返 回 的 这 个 UTI 是 一 个 代表 标识 符 的 字符 串 : 


@import MobileCoreServices; 


NSString *preferredUTIForExtension(NSString *ext) 


| 


// Request the UTI for the file extension 


NSString *theUTI - ( bridge transfer NSString *) 
UTTypeCreatePreferredidentifierForTag | 
kUTTagClassFilenameExtension, 
( bridge CFStringRef) ext, NULL); 
return theUTI; 


开发 者 也 可 以 不 传 入 文件 扩展 名 ， 而 是 传 入 MIME 类 型 ， 此 时 UTTypeCreatePreferred-ldentifierForTag() 的 第 一 个 参数 应 该 改 为 kUTTagClassMIMEType。 下 面 
这 个 函数 可 以 根据 给 定 的 MIM E 类 型 返回 首选 的 UTI: 


NSString *preferredUTIForMIMEType (NSString *mime) 
| 
// Request the UTI for the MIME type 
NSString *theUTI = ( bridge transfer NSString *) 
UTTypeCreatePreferredIdentifierForTag( 
kUTTagClassMIMEType, 
( bridge CFStringRef) mime, NULL); 
return theUTI; 


开发 者 可 以 用 上 面 这 两 个 函数 ， 把 文件 名 及 MIM E 类 型 转换 成 访问 文件 时 经 常会 用 到 的 UTI 类 型 。 


11.1.2 ”把 TI 转换 成 扩展 名 或 MIME 类 型 


UTTypeCopyPreferredTagWithClass(0 函 数 可 以 把 UTI 转 换 成 首选 的 扩展 名 或 MIME 类 型 。 如 果 给 下 面 这 两 个 函数 传 入 publicjpeg， 那 么 它们 融会 分 别 返 回 jpeg 
和 image/jpeg: 


NSString *extensionForUTI (NSString *aUTI) 


| 
CFStringRef theUTI - ( bridge CFStringRef) aUTI; 
CFStringRef results - 
UTTypeCopyPreferredTagWithClass( 
theUTI, kUTTagClassFilenameExtension); 
return ( bridge transfer NSString *)results; 


NSString *mimeTypeForUTI (NSString *aUTI) 


| 
CFStringRef theUTI - ( bridge CFStringRef) aUTI; 
CFStringRef results - 
UTTypeCopyPreferredTagwithClass ( 
theUTI, kUTTagClassMIMEType) ; 


return ( bridge transfer NSString *)results; 


使 用 这 两 个 国 数 的 时 候 ， 必 须 传 入 树 状 结构 最 底 端 的 UTI， 也 就 是 与 具体 的 扩展 名 直接 对 应 的 UTI。 开 发 者 不 能 只 给 出 上 级 UTI 的 类 型 。 扩 展 名 声明 在 属性 列表 中 ， 
像 文 件 扩展 名 及 默认 图 标 等 特征 信息 ， 都 是 在 属性 列表 里 描述 的 。 举 例 来 说， 开发 者 如 果 给 extensionForUTI 函 数 传 入 public.text 或 public.movie， 那 么 该 国 数 会 返回 
nil， 但 如 果 传 入 的 是 public.plain-text 和 public.mpeg， 则 会 分 别 返 回 txt 和 mpg。 

前 面 给 出 的 public.text 及 public.movie 这 两 个 UTI， 在 整个 树 状 结构 中 所 处 的 地 位 太 高 了 ，extensionForUTI 函 数 需要 开发 者 提供 更 加 具体 的 类 型 ， 而 不 是 这 种 比 
较 抽 象 的 类 型 。 目 前 并 没有 API 函 数 能 够 在 抽象 的 UTI 上 面 找 到 应 用 程序 中 继承 自 该 UTI 的 所 有 子 条 目 。 读 者 可 以 访问 bugreport.apple.com， 向 苹果 公司 提交 这 一 改进 
建议 。 肯 定 有 某 个 地 方 注册 了 所 有 的 扩展 名 和 和 MIME 类型， 不 然 的 话 ，UTTypeCopyPreferredTagWith-Class() 函 数 怎么 能 够 执行 转换 呢 ? 所 以 ， 笔 者 认为 ， 在 扩展 名 
与 更 加 通用 的 UTI 之 间 应 该 能 够 建立 起 对 应 关系 。 


MIMEHelper 类 


把 扩展 名 转换 成 UTI 的 操作 ， 基 本 上 都 可 以 得 到 结果 ， 开 发 者 只 要 把 扩展 名 传 给 extensionForUTI， 差 不 多 都 可 以 返回 UTI。 但 是 ， 把 UTI 转 换 成 MIME 的 操作 ， 却 
经 常会 落空 。 如 果 传 入 的 UTI 比 较 常 见 ， 那 么 通常 可 以 得 到 适当 的 MIME 类 型 ， 但 如 果 传 入 的 UTI 比 较 少 见 ， 那 就 很 难得 到 有 效 的 答案 了 。 


下 面 列 出 了 扩展 名 、UTI (通过 preferredUTIForExtension(0 国 数 获得 ) ， 以 及 根据 UTI 所 转换 出 来 的 MIME 类 型 (通过 mimeTypeForUTI( 冰 数 获得 ) : 


xlv: dyn.age81u5d0 / (null) 

xlw: com.microsoft.excel.xlw / application/vnd.ms-excel 
xm: dyn.age8lu5k / (null) 

xml: public.xml / application/xml 

z: public.z-archive / application/x-compress 

zip: public.zip-archive / application/zip 

zoo: dyn.age8ly55t / (null) 

zsh: public.zsh-script / (null) 


读者 可 以 看 到 ， 上 述 有 好 几 处 都 是 null。 如 果 mimeTypeForUTI(0 函 数 找 不 到 与 UTI 相 匹配 的 MIME 类 型 ， 那 就 会 返回 nil。 为 了 解决 此 问题 ， 本 解决 方案 的 范例 代 
码 提 供 了 名 为 MIMEHelper 的 辅助 类 。 它 定义 了 下 面 用 来 把 给 定 的 扩展 名 转换 成 MIME 类 型 的 消 数 : 


NSString *mimeForExtension(NSString *extension); 


该 函数 所 依据 的 扩展 名 及 MIME 类 型 ， 来 自 Apache Software Foundation (Apache 软 件 基金 会 ) 对 外 公布 的 一 份 列表 。 本 解决 方案 的 范例 代码 一 共 支 持 450 种 


扩展 名 ，iOS 系 统 能 够 查 出 与 这 450 种 扩展 名 相对 应 的 每 一 种 UTI， 但 却 只 能 把 其 中 的 89 种 转换 为 MIME 类 型 。 使 用 了 Apache 所 提供 的 数据 之 后 ， 我 们 可 以 识别 多 达 
230 种 MIME 类 型 。 


11.1.3. 判断 两 个 UTI 之 间 是 人 否 有 依从 天 系 


UTTypeConformsTo(0 函 数 可 以 判断 UTI 之 间 的 依从 天 系 。 此 函数 接收 两 个 参数 ， 一 个 表示 待 比较 的 源 UTI， 另 一 个 表示 用 于 参照 的 UTI。 如 果 前 者 遵循 后 者 ， 那 
么 函数 融 返 回 true。 通 过 这 个 函数 ， 我 们 可 以 判断 出 某 个 具体 的 UTI 是 否 遵循 另 一 个 宽泛 的 UTI。UTTypeEqualO0 轴 数 则 可 以 判断 两 个 UTI 是 否 相等 。 下面 这 段 范 例 代码 
演示 了 如 何 判 断 某 个 文件 路 径 是 否 指 向 图 像 资 源 : 


BOOL pathPointsToLikelyUTIMatch(NSString *path, CFStringRef theUTI) 


{ 
NSString *extension = [path pathExtension] ; 
NSString *preferredUTI = preferredUTIForExtension (extension); 
return (UTTypeConformsTo | 
( bridge CFStringRef) preferredUTI, theUTI)); 


BOOL pathPointsToLikelyImage (NSString *path) 


| 


return pathPointsToLikelyUTIMatch(path, CFSTR("public.image")); 


BOOL pathPointsToLikelyAudio(NSString *path) 


| 


return pathPointsToLikelyUTIMatch(path, CFSTR("public.audio")); 


11.1.4 ”获取 依从 天 系列 表 


在 iOSs 的 APl 中 ，UTTypeCopyDeclaration() 可 以 算是 最 为 通用 也 最 为 有 用 的 UTI 函 数 了 。 它 所 返回 的 字典 (dictionary) 中 包含 下 列 键 (key) : 
:kUTTypeldentifierKey 一 一 表示 调用 者 传 给 函数 的 UTI 名 称 〈 例 如 ，public.mpeg) 。 


- KUTTypeConformsTokKey 一 一 表示 该 类 型 所 遵循 的 上 级 类 型 (例如 ，public.mpeg 遵 循 public.movie) 。 


- kUTTypeDescriptionKey 一 一 如 果 UTI 名 称 还 有 一 种 易于 理解 的 描述 方式 ， 那 么 该 键 所 对 应 的 值 就 是 那 种 描述 方式 (例如 ，“MPEG movie” ) 。 


- kUTTypeTagSpecificationKey 一 一 该 键 对 应 于 一 份 字 典 ， 字 典 里 含有 与 调用 者 所 传 入 的 UTI 等 效 的 OSType (例如 MPG 与 MPEG) 、 文 件 扩展 名 (例如 mpg、 


mpeg. mpe, m7545m15) 及 MIME 类 型 (例如 video/mpeg、video/mpg、video/x-mpeg 与 Video/x-mpg) o 


除了 上 述 常 用 的 键 之 外 ， 还 有 一 些 键 用 于 指明 导入 和 导出 的 UTI 声 明 (kUTImpor-tedTypeDeclarationsKey 与 kKUTExportedTypeDeclarationsKey) 、 同 UTI 相 关 
联 的 图 标 资源 (kUTTypelconFileKey) 、 指 向 该 类 型 描述 页 面 的 URL (kUTTypeReference-URLKey) ， 以 及 该 UTI 的 版 本 字符 串 (kUTTypeVersionKey) 。 


开 友 者 可 以 在 UTTypeCopyDeclaration(0 所 返回 的 字典 上 面 ， 沿 着 依从 关系 树 进 行 志 历 ， 从 而 构建 出 一 份 数 组 ， 并 且 令 这 份 数 组 能 够 包含 该 UTI 所 遵循 的 全 部 上 级 
UTI。 比 方 说 ，public.mpeg 类 型 的 UTl 遵 循 public.movie、public.audiovisual-content、public.data、public.item 及 public.content。 解 决 方案 11-1 中 的 
conformanceArray 国 数 会 把 这 些 条 目 放 在 数组 里 面 返 回 给 调用 者 。 


解决 方案 11-1 测试 UTI 之 间 的 依从 关系 


// Build a declaration dictionary for the given type 
NSDictionary *utiDictionary (NSString *aUTI) 
{ 
NSDictionary *dictionary = 
( bridge transfer NSDictionary *) 
UTTypeCopyDeclaration(( bridge CFStringRef) aUTI); 
return dictionary; 


// Return an array where each member is guaranteed unique 
// but that preserves the original ordering wherever possible 
NSArray *uniqueArray(NSArray *anArray) 
{ 
NSMutableArray *copiedArray = 
[NSMutableArray arrayWithArray:anArray] ; 


for (id object in anArray) 


{ 


[copiedArray removeObjectIdenticalTo:object] ; 
[copiedArray addObject:object] ; 


return copiedArray; 


// Return an array representing all UTIs that a given UTI conforms to 
NSArray *conformanceArray (NSString *aUTI) 
{ 
NSMutableArray *results = 
[NSMutableArray arrayWithObject:aUTI]; 
NSDictionary *dictionary = utiDictionary (aUTI); 
id conforms = [dictionary objectForKey: 
( bridge NSString *)kUTTypeConformsToKey] ; 


// No conformance 
if (!conforms) return results; 


// Single conformance 
if ([conforms isKindOfClass: [NSString class]]) 


{ 


[results addObjectsFromArray:conformanceArray (conforms) ] ; 
return uniqueArray (results) ; 


// Iterate through multiple conformance 
if ([conforms isKindOfClass: [NSArray class] ]) 


{ 


for (NSString *eachUTI in (NSArray *) conforms) 
[results addObjectsFromArray:conformanceArray (eachUTI)]; 


return uniqueArray (results); 


// Just return the one-item array 
return results; 


获取 解决 方案 代码 


访问 https://github.com/erica/iOS-7-Cookbook 网 页 ， 并 打开 “C11Documents” 文 件 夹 ， 即 可 找到 与 本 章 中 的 解决 方案 相对 应 的 完整 范例 项 目 。 


11.2 解决 方案 : 访问 系统 剪贴 板 


剪贴 板 (pasteboard， 有 些 系统 将 其 称 为 clipboard) 为 操作 系统 提供 了 一 块 集中 存放 数据 的 区 域 ， 使 得 应 用 程序 之 间 可 以 共享 数据 。 用 户 可 以 在 某 个 程序 里 复制 
一 份 数据 ， 然 后 切换 到 其 他 程序 ， 将 那 份 数 据 粘 贴 到 那个 程序 里 。 大 部 分 操作 系统 里 面 都 有 与 剪 切 /复制 /粘贴 操作 类 似 的 功能 。 上 此外， 用户 也 可 以 在 同一 个 应 用 程序 内 
部 的 文本 框 与 视图 之 间 复 制 并 粘贴 数据 ， 而 开 友 者 则 可 以 创建 应 用 程序 专用 的 剪贴 板 ， 它 里 面 存放 的 数据 ， 其 他 程序 无 法 解读 。 


UIPasteboard 类 可 以 访问 设备 共用 的 草 贴 板 及 其 中 的 内 容 。 下 面 这 行 代码 可 以 返回 通用 的 系统 筋 贴 板 ， 绝 大 部 分 复制 /粘贴 操作 都 可 以 在 它 上 面 执行 : 
UIPasteboard *pb = [UIPasteboard generalPasteboard]; 


由 系统 所 提供 的 通用 剪贴 板 和 搜索 剪贴 板 是 设备 上 所 有 程序 共用 的 。 除 了 这 些 共 享 的 系统 剪贴 板 之 外 ，iOSs 还 提供 了 应 用 程序 专用 的 剪贴 板 ， 以 及 带 有 自 定 义 名 称 
的 部 贴 板 ， 同 一 个 组 织 里 共用 同一 个 团队 ID 的 应 用 程序 开发 者 ， 可 以 在 不 同 的 应 用 程序 之 间 使 用 这 些 剪 贴 板 。pasteboardWithUniqueName 方 法 可 以 创建 应 用 程序 
专用 的 剪贴 板 ， 该 方法 所 返回 的 剪贴 板 对 象 ， 会 一 直 延 续 到 应 用 程序 退出 时 为 止 。 


pasteboardWithName: create: 方法 用 来 创建 共享 的 剪贴 板 ， 该 方法 会 返回 具备 指定 名 称 的 剪贴 板 。create 人 参数 的 意思 是 : 如 果 系 统 里 没有 这 一 剪贴 板 ， 那 么 
是 否 应 该 新 建 它 。 创 建 好 剪贴 板 后 ， 如 果 把 persistent 属 性 设 为 YES， 那 它 就 可 以 在 程序 运行 完毕 后 继续 保留 其 数据 了 。 


Qi 在 iOS 7 之 前 的 系统 里 ， 开 发 者 可 以 根据 剪贴 板 的 名 称 ， 在 所 有 应 用 程序 之 间 共 享 带 有 自 定 义 名 称 的 剪贴 板 ， 而 不 是 只 能 在 同一 个 组 织 的 同一 个 开发 团队 
里 面 共 享 。 此 特性 在 iOS 7 系统 中 有 所 变化 ，《iOS 7Release Notes》 里 面 说 明了 这 一 点 。 原 来 有 许多 程序 会 共用 这 种 自 定 义 的 剪贴 板 ， 而 现在 ， 这 些 程序 无 法 按照 以 前 
的 方式 继续 运作 下 去 了 。 我 们 需要 采用 新 的 办 法 在 程序 间 分 享 数 据 。 比 方 说 ， 可 以 考虑 解决 方案 11-8 中 的 openURL， 或 是 采用 外 部 共享 的 存储 区 。 


11.2.1 FSUE 


剪贴 板 中 可 以 存放 一 项 或 多 项 数据 。 剪 贴 板 中 的 每 项 数据 ， 都 可 以 表示 成 一 份 包含 若干 键 值 对 的 字典 ， 键 值 对 里 存放 有 数据 及 其 类 型 。 剪 贴 板 里 的 某 项 数据 ， 可 
以 含有 多 份 与 之 相关 的 条 目 ， 以 便 使 其 他 程序 能 够 找到 它们 所 兼容 的 数据 类 型 。 我 们 常用 UTI 来 表示 数据 类 型 。 比 方 说 ， 可 以 用 public.text 类 型 (具体 来 说 就 是 
public.utf8-plain-text 类 型 ) 来 存放 文本 数据 ， 可 以 用 public.url| 类 型 来 保存 URL 地 址 ， 或 是 用 public.jpeg 类 型 来 存放 图 像 数 据 。 这 都 是 iOS 程 序 常用 的 数据 类 型 。 


UlPasteboard 提 供 了 一 些 方法 ， 有 的 可 以 处 理 一 个 吝 贴 板 条 目 ， 有 的 可 以 处 理 多 个 剪贴 板 条 目 ， 另 外 还 有 一 些 方法 用 于 获取 和 设置 草 贴 板 数 据 ， 以 及 查询 剪贴 板 
中 的 数据 类 型 。 处 理 单个 部 贴 板 数 据 所 用 的 那些 方法 ， 其 中 有 很 多 处 理 的 都 是 剪贴 板 里 的 首 个 条 目 。 开 发 者 可 以 经 由 items 属 性 获取 包含 全 部 条 目的 数组 。 


开发 者 可 以 给 剪贴 板 中 的 首 个 条 目 赋予 一 个 NSData 对 象 以 及 一 个 描述 数据 类 型 的 UTI， 以 便 把 该 条 目的 数据 同 其 类 型 关联 起 来 : 


[ [UIPasteboard generalPasteboard] 
setData:theData forPasteboardType:theUTI]; 


另外 ， 对 于 属性 列表 式 的 对 象 (1] (property list object， 也 就 是 字符 串 、 晶 期、 数组、 字典、 数值 或 URL) 来 说 ， 可 以 通过 setValue: forPasteboardType: 方法 
把 它们 放 到 剪贴 板 中 ( 译 者 批注 : 该 方法 的 第 一 个 参数 是 id 型 ， 所 以 ， 为 了 谨慎 起 见 ， 译 文 没有 翻译 句 中 的 NSValue。) 。 这 些 属性 列表 式 的 对 象 的 内 部 存储 方式 与 
等 效 的 原始 数据 (raw-data) 不 同 ， 这 体现 出 了 setValue: forPasteboardType: 方法 与 setData: forPasteboardType: 方法 之 间 的 区 别 。 


[1] 此 概念 请 参阅 iDS 开 发 文档 中 的 《About Property Lists? o 


译 者 注 


11.2.2 TRAS VURRIA 


剪贴 板 还 为 某 些 数据 类 型 提供 了 专门 的 方法 ， 这 些 数 据 类 型 表示 几 种 最 常 使 用 的 剪贴 板 条 目 。 它 们 是 : 颜色 (这 不 是 一 种 属性 列表 式 的 对 象 ) 、 图 像 (这 也 不 属 
于 属性 列表 陈 的 对 象 ) 、 字 符 串 及 URL。UIPasteboard 类 提供 了 专用 的 设置 器 (getter) 与 获取 器 (setter) ， 使 得 开 上 友 者 可 以 更 加 方便 地 处 理 这 几 种 数据 类 型 。 我 们 
可 以 将 其 当成 剪贴 板 的 属性 ， 直 接 以 “” 写 法 来 设置 并 获取 它们 。 另 外 ， 每 个 属性 都 有 一 种 对 应 的 复数 形式 ， 这 使 得 开 友 者 可 以 经 由 对 象 数组 来 操作 它们 。 


上 面 提 到 的 这 些 剪 贴 板 属性 ， 极 大 地 简化 了 向 系统 问 贴 板 里 放置 常用 数据 时 所 需 编写 的 代码 。 可 供 使 用 的 属性 有 下 面 这 些 : 
- String 一 一 把 剪贴 板 中 的 首 个 条 目 当成 字符 串 来 设置 或 获取 。 
: Strings 一 一 把 剪贴 板 中 的 所 有 条 目 当 成 字符 串 数 组 来 设置 或 获取 。 
.Image 一 一 把 剪贴 板 中 的 首 个 条 目 当 成 图 像 来 设置 或 获取 。 


-Images 一 一 把 剪贴 板 中 的 所 有 条 目 当 成 图 像 数 组 来 设置 或 获取 。 


- URL 一 一 把 剪贴 板 中 的 首 个 条 目 当 成 URL 来 设置 或 获取 。 
: URLs 一 一 把 剪贴 板 中 的 所 有 条 目 当 成 URL 数 组 来 设置 或 获取 。 
.Color 一 一 把 剪贴 板 中 的 首 个 条 目 当成 颜色 对 象 来 设置 或 获取 。 


colors- 一 一 把 剪贴 板 中 的 所 有 条 目 当成 颜色 对 象 数组 来 设置 或 获取 。 


11.2.3 ”获取 数据 
如 果 要 获取 的 数据 属于 前 一 节 所 提 到 的 四 种 类 型 ， 那 么 只 需 使 用 相关 的 属性 即 可 将 其 从 剪贴 板 里 取出 来 。 否 则 ， 需 要 用 dataForPasteboardType: 方法 来 获取 。 
该 方法 只 会 返回 剪贴 板 第 一 个 条 目 里 的 数据 ， 而 忽略 剪贴 板 中 的 其 他 条 目 。 


要 想 获 取 与 某 些 类 型 相符 的 所 有 数据 ， 需 要 调用 itemSetWithPasteboardTypes: 方法 ， 并 在 返回 的 NSiIndexSet 上 面 疡 历 ， 以 访问 其 中 的 每 个 字典 。 然 后 通过 字 
典 里 的 键 和 值 来 查 明 该 条 目 所 含 的 数据 类 型 及 数据 内 容 。 

当前 贴 板 中 的 数据 有 变化 时 ， 它 会 发 出 UlPasteboardChangedNotification 通 知 ， 开 发 者 可 以 通过 NSNotificationCenter 中 默认 的 那些 方法 来 添加 监听 器 ， 以 便 
监听 此 通知 。 另 外 ， 也 可 以 监听 UlIPasteboardRemovedNotification ， 以 便 在 某 条 目 移 出 剪贴 板 时 得 到 通知 。 


Qi 如 果 想 把 文本 数据 顺利 粘贴 到 Notes 或 Mail 程 序 ， 那么 在 向 剪贴 板 中 存储 文本 信息 时 ， 应 该 使 用 public.utf8-plain-text 类 型 的 UTI。 若 通过 string 或 strings 属 性 
来 保存 文本 ， 则 系统 会 默认 使 用 该 类 型 。 


11.24 BAZEN 


坦率 地 说 ，iOS 的 选取 与 复制 界面 ， 并 不 是 整个 操作 系统 里 最 简洁 的 UI 元 件 。 有 的 时 候 ， 为 了 简化 用 户 的 操作 流程 ， 我 们 会 把 可 能 要 与 其 他 应 用 程序 分 享 的 那些 内 
容 提 前 准备 好 。 


请 看 解决 方案 11-2。 用 户 在 文本 视图 (UlTextView) 里 面 输入 并 编辑 文本 的 时 候 ， 程 序 会 自动 把 文本 更 新 到 剪贴 板 。 如 果 enableWatcher 变 量 处 于 启用 状态 (用 
尸 可 以 通过 点 击 按钮 来 局 用 它 ) ， 那 么 每 次 编辑 文本 时 ， 程 序 都 会 把 文本 更 新 到 剪贴 板 。 为 了 实现 此 功能 ,我 们 编写 了 UlTextViewDelegate 协 议 中 的 
textViewDidChange: 方法 ,以便 咽 应 用 户 的 编辑 操作 。 在 该 方法 中 ， 我 们 通过 updatePasteboard 方 法 把 改变 之 后 的 文本 内 容 自动 粘贴 到 剪贴 板 里 面 。 


解决 方案 11-2 ”自动 把 文本 复制 到 剪贴 板 里 
- (void)updatePasteboard 


// Copy the text to the pasteboard when the watcher is enabled 
if (enableWatcher) 
[UIPasteboard generalPasteboard].string - textView.text; 


- (void)textViewDidChange: (UITextView *)textView 


// Delegate method calls for an update 
[self updatePasteboard] ; 


- (void) toggle: (UIBarButtonItem *)bbi 


| 


// switch between standard and auto-copy modes 
enableWatcher = !enableWatcher; 
bbi.title = enableWatcher ? @"Stop Watching" : @"Watch"; 


通过 本 条 解决 万 案 可 以 看 出 ， 访 问 及 更 新 剪贴 板 是 一 件 相 对 简单 的 事 。 


11.3 解决 方案 : 监控 Documents 文 件 夹 


iOS 的 文档 并 不 忌 是 局 限 在 沙 金 之 中 。 开 发 者 可 以 而 且 也 应 该 为 用 尸 提 供 文 档 分 享 功能 。 我 们 应 该 令 用 尸 能 够 直接 控制 他 们 的 文档 ， 并 且 能 够 访问 到 他 们 在 设备 上 
创建 的 任何 内 容 。 开 发 者 只 需 在 Info.plist 中 启用 一 个 简单 的 设置 ， 就 可 以 令 iTunes 显 示 出 用 户 Documents 文 件 夹 下 的 内 容 ， 并 且 可 以 令 用 户 能 够 按照 自己 的 需要 来 添 
加 并 删除 这 些 内 容 。 


过 一 阵子 ， 也 许 开 发 者 就 可 以 通过 NSMetadataQuery 来 监控 Documents 文 档 并 观察 其 中 的 更 新 了 。 但 在 笔者 编写 本 书 时 ， 它 所 能 监控 的 元 数据 (metadata) (X 
仅 局 限 在 iCloud 上 自身 的 目录 之 中 。 从 OS3 X 移 植 过 来 的 代码 ， 无 法 顺利 运行 在 iOS 平 台 上 面 。 准 确 地 说 ， 目 前 只 支持 两 种 搜索 范围， 分 别 是 
NSMetadataQueryUbiquitousDataScope 和 NSMetadataQueryUbiquitousDocumentsScope， 而 这 两 种 搜索 范围 义 都 局 限 在 iCloud 之 中 。 在 iOS 尚 未 支持 更 加 通 
用 的 监控 功能 时 ， 我 们 应 该 使 用 kqueue 来 编程 。 这 项 比较 旧 的 技术 提供 了 灵活 的 事件 通知 功能 。 开 发 者 可 以 通过 kKkqueue 来 监控 、 添 加 并 清除 事件 。 这 样 做 大 致 相当 
于 检测 文件 的 添加 及 删除 情况 ， 而 这 两 种 情况 正 是 应 用 程序 要 响应 的 主要 状况 。 后 面 的 解决 方案 11-3 演 示 了 如 何 用 kqueue 来 监控 Documents 文 件 夹 。 


11.3.1 局 用 文件 分 享 功 能 


若 要 启用 文件 分 享 功能 ， 请 向 应 用 程序 的 Info.plist 里 面 添加 名 为 Application supports iTunes file sharing 的 键 (key) ， 并 把 其 值 设 为 YES。 开 发 者 可 以 直接 编 
辑 plist， 也 可 以 用 Xcode 里 面 的 编辑 器 来 修改 它 。 如 果 想 用 编辑 器 修改 ， 那 就 切换 到 Project>Target>1nfo 男 面 ， 并 在 Custom iOS Target Properties 区 域 中 操作 相关 
属性 ， 如 图 11-2 所 示 。 若 要 直接 操作 它 的 值 ， 则 需 使 用 名 为 UlFileSharingEnabled 的 键 。iTunes 会 把 支持 文件 分 享 功能 的 所 有 应 用 程序 都 列 在 每 台 设 备 的 Apps 清 单 
中 ， 如 图 11-3 所 示 。 


11.3.2 ”用 户 对 Documents 文 件 夹 的 控制 能 


开发 者 不 能 限定 Documents 文 件 夹 里 的 文件 类 型 。 用 户 可 以 把 任意 类 型 的 文件 添加 到 里 面 ， 也 可 以 移 除 不 想 要 的 东西 。 但 是 ， 他 们 却 不 能 在 iTunes 的 界面 里 浏览 
Documents 文 件 夹 中 的 子 文件 夹 。 请 看 图 11-3 中 的 Inbox 文 件 夹 。 该 文件 夹 是 开发 者 在 应 用 程序 之 间 分 享 文档 后 所 留 下 的 痕迹 ， 它 本 来 是 不 应 该 出 现在 Documents 里 
面 的 。 用 户 不 能 直接 管理 这 些 数据 ， 而 开发 者 也 不 应 该 把 这 样 的 子 目 录 留 在 这 里 ， 否 则 ， 用 户 会 感到 困惑 。 


uu | a > | F5 Hello World 
[El General Capabilities Info Build Settings Build Phases Build Rules 


PROJECT 


Y Custom iOS Target Properties 
Hello World 


Key Type Value 

String 1.0 

String com.sadun.S[PRODUCT. NAM 
String 6.0 

String ${/PRODUCT_NAME} 

String 1.0 

Application supports iTunes file sharing “ Boolean 

Executable file String SIEXECUTABLE NAME 
Application requires iPhone environment : Boolean YES 


TARGETS Bundle versions string, short 
Helo World: Bundle identifier 
Add Target... InfoDictionary version 


Bundle name 


PFa@arar ah ak 


Bundle version 


b Supported interface orientations Array (3 items) 
Bundle display name String ${(PRODUCT_NAME} 
Bundle OS Type code String APPL 
Bundle creator OS Type code String rrr? 
Localization native development region String en 
P Supported interface orientations (iPad) Array (4 items) 
> Required device capabilities Array (1 item) 


图 11-2 ŠM “Application supports iTunes file sharing” 功能 ， 使 得 用 户 可 以 通过 iTunes 来 访问 Documents 文 件 夹 


File Sharing 


The applications listed below can transfer documents between your iPad and this computer. 


Apps Doc Tool Documents 


TS Air Sharing | * 00-0321659570 print.pdf 
AVServices.xls 
Bochs ~~ Beta.doc 
* C.pdf 
eal Doc Teo!  — Documents.ppt 
* IMG 0041.JPG 


一 . DocsAnywhere « IMG 0069JPC 
| * IMG 0072.JPG 

| GoodReader - 
© IMG 0078JPG 

Lo. Keynote * IMG 06538,JPG 

z * |MG 2041JPC 
me Numbers * IMG 2045.PG | 
uu J Inbox 4/18/10 5:06 PM 24.9 MB 


— 4 F 
“Al OmniGrafile Th om NT . Serr a eon oe 
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图 11-3 ”凡是 宣称 自己 支持 UIFileSharingEnabledq 功 能 的 应 用 程序 ， 都 会 出 现在 iTunes 的 Apps 列 表 中 


在 iTunes 中 ， 用 户 不 能 像 删除 其 他 内 容 那样 删除 Inbox 广 件 夹 。 而 我 们 的 应 用 程序 ， 也 不 应 该 直接 把 文件 写 到 Inbox 里 。 此 文件 夹 专门 用 来 捕获 由 其 他 程序 分 享 过 
来 的 数据 ， 开 发 者 应 该 明确 它 的 这 一 用 途 。 如 果 要 实现 文件 分 享 功 能 ,那么 在 重新 启动 应 用 程序 时 ， 应 该 检查 Inbox 文 件 夹 ， 并 恢复 到 上 次 运行 时 的 状态 ， 同 时 ， 应 该 
把 Inbox 里 的 数据 处 理 干 净 ， 并 将 其 删除 。 本 章 稍 后 将 会 讨论 : 怎样 恰当 地 处 理由 其 他 程序 分 享 过 来 的 文档 。 


11.3.3 ”在 Xcode 里 访问 应 用 程序 沙 盒 
开发 者 不 仪 能 够 访问 Documents 文 件 来， 而且 还 能 访问 整个 应 用 程序 沙 合 。 在 Xcode 中 ， 通 过 Organizer (可 按 “Command-Shift-2” 组 合 键 调 出 该 界 
面 ) »Devices» Device (具体 的 设备 ) >Applications>Application Name (应 用 程序 名 称 ) ， 即 可 浏览 沙 盒 、 向 沙 盒 里 上 传 文件 ， 并 从 沙 盒 中 下 载 文 件 。 


若 要 测试 文件 分 享 功能 ， 我 们 可 以 启用 应 用 程序 的 UlFileSharingEnabled 属 性 ， 并 向 Documents 文 件 夹 里 上 传 一 些 数 据 。 等 创建 好 这 些 文件 后 ， 用 Xcode 及 
iTunes 来 查看 、 下 载 并 删除 它们 。 


11.3.4“ 扫 拓 新 的 文档 


解决 方案 11-3 在 beginGeneratingDocumentNotificationsinPath: 方法 中 请 求 系统 用 kqueue 来 投递 通知 。 该 方法 根据 开发 者 所 提供 的 路 径 (在 本 例 中 ， 该 路 径 
就 是 程序 的 Documents 文 件 夹 ) 来 获取 文件 描述 符 ， 然 后 据 此 请 求 系 统 在 适当 的 时 机 向 队列 中 添加 事件 或 清除 事件 的 状态 。 它 把 这 个 功能 添加 到 当前 的 “运行 循 
环 ” (run loop) 里 面 ， 这 样 的 话 ， 只 要 待 监 控 的 文件 夹 发 生变 化 ， 就 可 以 触发 通知 了 。 


解决 方案 11-3 ”通过 kqueue 来 监控 文件 变化 


#import «fcntl.h» 
#import «sys/event.h» 


#define kDocumentChanged ^ 
Q"DocumentsFolderContentsDidChangeNotification" 


@interface DocWatchHelper : NSObject 
Gproperty (strong) NSString *path; 

+ (id)watcherForPath: (NSString *)aPath; 
@end 


@implementation DocWatchHelper 


| 


CFFileDescriptorRef kqref; 
CFRunLoopSourceRef rls; 


- (void)kqueueFired 


| 
int kq; 
struct kevent event; 
struct timespec timeout = { 0, 0 }; 
int eventCount; 


kq = CFFileDescriptorGetNativeDescriptor(self-»kqref); 


assert(kq >= 0); 


eventCount - kevent(kq, NULL, 0, &event, 1, &timeout); 
assert( (eventCount »- 0) && (eventCount « 2) ); 


if (eventCount -- 1) 
([NSNotificationCenter defaultCenter] 
postNotificationName:kDocumentChanged 
object:self]; 


CFFileDescriptorEnableCallBacks(self-»kqref, 
kCFFileDescriptorReadCallBack); 


static void KQCallback(CFFileDescriptorRef kqRef, 
CFOptionFlags callBackTypes, void *info) 


DocWatchHelper *helper - 
(DocWatchHelper *)( bridge id) (CFTypeRef) info; 
[helper kqueueFired] ; 
} 
- (void) beginGeneratingDocumentNotificationsInPath: 
(NSString *)docPath 


int dirFD; 
int kq; 


Tae retVal- 


— A — = — w w VO f 


struct kevent eventToAdd; 
CFFileDescriptorContext context - 
{ 0, (void *)( bridge CFTypeRef) self, 
NULL, NULL, NULL }; 


dirFD - open([docPath fileSystemRepresentation], 


assert(dirFD >= 0); 


kq = kqueue() ; 
assert (kq >= 0); 


eventToAdd.ident = dirFD; 
eventToAdd.filter = EVFILT VNODE; 
eventToAdd.flags = EV ADD | EV CLEAR; 
eventToAdd.fflags - NOTE WRITE; 
eventToAdd.data m ie 
eventToAdd.udata = NULL; 


O EVTONLY); 


retVal = kevent (kq, &eventToAdd, 1, NULL, 0, NULL); 


assert (retVal == O0); 


self-»kqref = CFFileDescriptorCreate (NULL, kg, 
true, KQCallback, &context); 
rls - CFFileDescriptorCreateRunLoopSource( 


NULL, self->kqref, 0); 
assert(rls != NULL); 


CFRunLoopAddSource (CFRunLoopGetCurrent(), rls, 
kCFRunLoopDefaultMode) ; 
CFRelease (rls); 


CFFileDescriptorEnableCallBacks (self->kqref, 
kCFFileDescriptorReadCallBack); 


- (void)dealloc 
| 
self -path = mil; 
CFRunLoopRemoveSource (CFRunLoopGetCurrent(), rls, 
kCFRunLoopDefaultMode); 
CFFileDescriptorDisableCallBacks (self-»kqref, 
kCFFileDescriptorReadCallBack); 


+ (id)watcherForPath: (NSString *)aPath 


| 


DocWatchHelper *watcher - [[self alloc] init]; 

watcher.path - aPath; 

[watcher beginGeneratingDocumentNotificationsInPath:aPath]; 
return watcher; 


| 


@end 


在 收 到 回调 的 时 候 ， 它 会 投递 通知 (比方 说 ， 本 例会 在 KkqueueFired 方 法 中 投递 自 定 义 的 kDocumentChanged 通 知 ) 并 继续 监控 新 的 事件 。 由 于 这 些 操作 都 运行 
在 主线 程 的 主 运行 循环 里 面 ， 所 以 GUI 依然 能 够 响应 用 户 的 操作 ， 并 且 能 在 收 到 通知 的 时 候 更 新 自己 。 


下 面 这 段 学 例 代 码 演示 了 如 何 用 解决 方案 11-3 的 DocWatchHelper 来 更 新 GUI 中 的 文件 列表 。 当 文件 夹 的 内 容 有 变化 时 ， 系 统 会 给 程序 友人 送 通知 ， 而 程序 则 会 据 
此 刷新 列表 ， 以 反映 文件 夹 中 的 新 内 容 : 


- (void)scanDocuments 


NSString *path = [NSHomeDirectory() 
stringByAppendingPathComponent :@"Documents"] ; 
items - [[NSFileManager defaultManager] 
contentsOfDirectoryAtPath:path error:nil]; 
[self.tableView reloadData]; 


- (void)viewDidLoad 


[super viewDidLoad] ; 
[self.tableView registerClass: [UITableViewCell class] 


forCellReuseIdentifier:G"cell"]; 
[self scanDocuments]; 


// React to content changes 

[[NSNotificationCenter defaultCenter] 
addObserverForName:kDocumentChanged 
object:nil queue: [NSOperationQueue mainQueue] 
usingBlock:^(NSNotification *notification) { 
[self scanDocuments] ; 


H; 


// Start the watcher 

NSString *path = [NSHomeDirectory () 
stringByAppendingPathComponent :@"Documents"] ; 

helper = [DocWatchHelper watcherForPath:path] ; 


| 


测试 这 条 解决 方案 的 时 候 ， 请 把 设备 与 Tunes 相 连 。 然 后 用 Tunes 的 App 界 面 来 添加 并 删除 文件 。 此 时 ， 设 备 上 面 的 文件 列表 就 会 随 着 用 户 的 操作 而 持续 更 新 
T: 

在 使 用 解决 方案 11-3 的 时 候 ， 有 几 个 问题 要 注意 。 首 先 ， 如 果 系 统 在 创建 某 个 文档 的 时 候 通知 了 应 用 程序 ， 而 这 个 文档 又 比较 大 ， 那 就 不 要 在 接 到 通知 之 后 立即 
读 取 其 内 容 ， 而 是 应 该 持续 查询 文件 的 大 小 ， 以 判断 数据 是 否 已 经 完全 写 入 文件 之 中 了 。 其 次 ，iTunes 的 文件 传输 功能 可 能 偶尔 会 卡 住 ， 开 发 者 需要 根据 情况 做 出 适 
当 处 理 。 


11.4 解决 方案 : 活动 视图 控制 器 


iOS 6 引入 了 活动 视图 控制 器 [， 它 可 以 把 与 数据 相关 的 操作 集成 到 图 11-4 这 样 的 界面 中 。 开 发 者 只 需 编写 很 少 一 点 代码 ， 就 可 以 使 用 这 个 控制 器 了 。 它 使 得 用 户 
可 以 把 数据 复制 到 剪贴 板 、 发 布 到 社交 网 站 ， 或 通过 电子 邮件 及 短信 分 享 数据 等 。 内 置 的 操作 包括 : 发 布 到 Facebook、 发 布 到 Twitter、 发 布 到 Weibo、 发 送 短信 和 、 
发 送 电子 邮件 、 打 印 、 复 制 到 剪贴 板 、 添 加 到 联系 人 信息 中 ， 以 及 保存 到 Camera Roll, iOS 7 又 添加 了 一 些 新 的 操作 ， 包 括 : 添加 到 阅读 列表 、 发 布 到 Flickr、 发 布 到 
Vimeo, AMF Tencent Weibo 以 及 分 享 到 AirDrop。 程 序 也 可 以 定义 自己 特有 的 操作 ， 本 节 稍 后 会 讲 到 这 个 功能 。 下 面 列 出 目前 文 持 的 所 有 操作 类 型 : 
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图 11-4 UlActivityViewController 类 提供 了 一 些 系 统 服 务 及 自 定义 服务 
: UIActivityTypePostToFacebook 
: UIActivityTypePostToTwitter 
: UIActivityTypePostToWeibo 
: UlActivityTypeMessage 
: UlActivityTypeMail 
: UlActivityTypePrint 
: UIActivityLypeCopy LoPasteboard 
: UlActivityTypeAssignToContact 


: UIActivityIypeSaveToCameraRoll 


: UIActivity IypeAddToReadingList 


- UlActivityTypePostToFlickr 


: UlActivityTypePostToVimeo 


: UlActivityTypePostToTencentWeibo 


: UlActivityTypeAirDrop 
上 面 显然 缺少 两 项 重要 的 操作 : 一 个 是 “在 .… 中 打开 ” (Open in...) ， 访 操作 可 以 在 程序 乙 间 共 享 文档 ; 另 一 个 是 “Quick Look” (快速 查看 ) ， 该 操作 可 以 


HWA 


预 抑 文件 内 容 。 本 章 稍 后 会 谈 到 这 两 个 功能 ， 也 会 用 解决 方案 来 演示 如 何 将 其 独立 地 实现 出 来 ， 另 外 ， 还 会 讲解 怎样 把 Quick Look 功 能 集成 到 活动 视图 控制 器 里 面 。 


[1] 这 里 的 活动 (activity) 一 词 ， 可 以 理解 成 “操作 ”或 “动作 o 


译 者 注 


11.4.1 ”展示 活动 视图 控制 器 


这 种 控制 器 的 展示 方式 ， 应 该 由 具体 设备 决定 。 如 果 是 在 iPhone 上 面 ， 那 就 应 该 以 模仿 界面 的 形式 来 展示 ， 但 若 在 平板 电脑 上 ， 则 应 将 其 展示 为 popover。 
UlBarButton-SystemltemAction 图 标 最 适合 用 来 把 UlBarButtonltem 与 该 控制 器 联系 起 来 。 


在 比较 理想 的 状况 下 ， 开 发 者 几乎 无 须 编写 其 他 代码 ， 即 可 实现 数据 分 享 。 当 用 户 选 定 某 个 操作 之 后 ， 控 制 器 会 自动 处 理 接 下 来 的 事情 ， 例 如 : 展示 电子 邮件 撰 
写 界 面 、 展 示 Twitter 消 息 撰写 界面 、 将 图 片 添加 到 设备 媒体 库 ， 或 是 把 图 片 设置 成 联系 人 的 头像 。 


11.4.2. UIActivityltemSource 协 议 


解决 方案 11-4 创 建 并 展示 了 活动 视图 控制 器 。 它 的 主 类 实现 了 UIActivityltem-Source 协 议 ， 并 且 把 self (自己 ) 放 在 数组 中 ， 通 过 activityltems 参 数 传 给 控制 
ES: 


UIActivityViewController *activity - 
[[UIActivityViewController alloc] initWithActivityItems:G [self] 
applicationActivities:nil] ; 
[self presentViewController:activity] ; 


实现 了 UIActivityltemsource 协 议 的 那个 对 象 ， 负 责 提供 将 要 操作 的 数据 ， 而 在 本 例 中 ， 该 对象 残 是 self。 


协议 中 有 两 个 必须 要 实现 的 方法 ， 分 别 用 来 提供 待 处 理 的 数据 (用 户 所 选 的 操作 融 是 针对 这 个 数据 执行 的 ) ， 以 及 与 该 数据 相对 应 的 占 位 符 。 用 来 表示 该 数据 的 
那个 对 象 ， 应 该 与 给 定 的 操作 类 型 相符 。 我 们 可 以 根据 系统 传 给 回调 方法 的 操作 类 型 来 提供 不 同 的 数据 对 象 。 比 方 说 ， 操 作 类 型 如 果 是 “上 友 布 Twitter 消息 ”， 那 么 该 
方法 返回 的 可 能 束 是 含有 “| created a great song in App Name" (我 在 某 程序 里 创建 了 一 首 动 听 的 歌曲 ) 字样 的 字符 串 ， 但 如 果 是 “友和 送 电子 邮件 ”， 那 么 该 万 
法 可 能 会 把 包含 声音 信息 的 实际 文件 上 友 过 去 。 


解决 方案 11-4 ”活动 视图 控制 器 


- (void)presentViewController: 
(UIViewController *)viewControllerToPresent 


if (popover) [popover dismissPopoverAnimated:NO]; 
if (IS IPHONE) 
| 
[self presentViewController:viewControllerToPresent 
animated:YES completion:nil]; 


| 


else 
| 
popover - [[UIPopoverController alloc] 
initWithContentViewController:viewControllerToPresent]; 
popover.delegate - self; 
[popover presentPopoverFromBarButtonItem: 
self.navigationItem.leftBarButtonItem 
permittedArrowDirections:UIPopoverArrowDirectionAny 
animated:YES]; 


// Popover was dismissed 
- (void)popoverControllerDidDismissPopover: 
(UIPopoverController *)aPopoverController 


popover - nil; 


// Return the item to process 

- (id)activityViewController: 
(UIActivityViewController *)activityViewController 
itemForActivityType: (NSString *)activityType 


return imageView.image; 


// Return a thumbnail version of that item 
- (id)activityViewControllerPlaceholderItem: 
(UIActivityViewController *)activityViewController 


return imageView.image; 


// Create and present the view controller 
- (void)action 


| 


UIActivityViewController *activity - 
[[UIActivityViewController alloc] 
initWithActivityItems:G [self] 
applicationActivities:nil]; 
[self presentViewController:activity] ; 


占 位 符 一 般 来 识 都 与 返回 的 数据 对 象 相 同 ， 除 非 我 们 需要 在 对 象 上 面 另 做 处 理 ， 或 是 要 创建 不 同 的 对 象 。 此 时 ， 开 发 者 可 以 创建 不 仿真 实数 据 的 占 位 符 对 象 。 
由 于 这 两 个 回调 方法 都 运行 在 主线 程 上 面 ， 所 以 我 们 应 该 尽量 把 数据 设计 得 小 一 些 。 如 果 要 处 理 数 据 ， 那 么 可 以 考虑 使 用 下 一 节 所 讲 的 UIActivityltemProvider。 


IOS 7 还 引入 了 几 个 可 选 的 方法 ， 开 发 者 可 以 经 由 这 几 个 委托 方法 来 进一步 配置 竺 操作 的 数据 。 这 些 委托 方法 可 以 用 来 提供 缩 略图 、 主 题 文 本 ， 以 及 与 特定 操作 类 
型 相对 应 的 UTI。 如 果 用 户 所 要 执行 的 操作 文 持 这 些 信息 ， 那 么 相关 的 服务 残 可 以 使 用 它们 。 


11.4.3 UlActivityltemProviderzs 


UlActivityltemProvider a JÆ E—T5 Pre PS CHT je, ASSIMBSUIActivityltemSourcet/X,, CARA LAUR BAA SUS BSR FEE. iX 
类 继承 了 NSOperation 类 ， 这 使 得 我 们 可 以 在 操作 数据 之 前 对 其 进行 一 些 灵 活 的 处 理 。 比 方 说 ， 在 向 社交 网 站 上 传 一 份 大 的 视频 文件 之 前 ， 我 们 想 先 处 理 这 份 文件 ， 
或 是 在 使 用 一 份 较 长 的 音频 文件 之 前 ， 我 们 想 先 截取 其 中 的 一 段 内 容 。 


开发 者 应 该 从 UIActivityltemProvider 中 继承 子 类 ， 并 实现 item 方 法 。 在 使 用 一 般 的 NSOperation 时 ， 我 们 会 实现 main 方 法 ， 而 在 使 用 时 需要 实现 的 则 是 item 方 
法 。 开 友 者 可 以 在 该 方法 中 生成 处 理 过 的 数据 ， 这 样 做 不 会 妨碍 用 尸 对 程序 的 操作 ， 因 为 它 是 异步 执行 的 。 


11.4.4 ”实现 UIActivityltemSource 协 议 中 的 回调 方法 


解决 方案 11-4 在 初始 化 控制 器 的 时 候 ， 把 自己 (self) 放 在 了 数组 中 ， 并 传 给 了 activityltems 参 数 。 由 于 自身 实现 了 UIActivityltemSource 协 议 ， 所 以 控制 器 在 收 
到 用 户 的 请 求 时 ， 就 会 通过 回调 方法 来 索取 待 操作 的 数据 。 在 回调 方法 中 ， 我 们 可 以 根据 数据 的 用 途 来 决定 需要 返回 什么 样 的 数据 。 开 发 者 可 以 根据 操作 类 型 ( 比 
如 ， 是 分 享 到 Facebook 还 是 添加 到 联系 人 信息 里 ， 本 节 前 面 列 出 了 各 种 操作 类 型 ) 来 提供 准确 的 数据 。 如 果 要 为 不 同 的 用 途 准 备 不 同 质量 的 资源 ， 那 么 操作 类 型 残 显 
得 尤为 重要 了 。 比 方 说 ， 如 果 用 户 要 打印 某 份 数据 ， 那 么 我 们 应 该 提供 高 质量 的 资源 ， 但 如 果 要 把 数据 分 享 到 Twitter， 那 么 只 需 提供 一 张 质量 较 低 的 图 像 就 行 了 。 


如 果 程 序 针 对 各 种 操作 所 返回 的 都 是 同一 份 数据 (比方 说 ， 无 论 用 户 是 要 在 Facebook 上 面 发 布 信息 ， 还 是 要 通过 电子 邮件 来 传送 信息 ， 我 们 都 返回 相同 的 数 
据 ) ， 那 么 ， 直 接 把 数据 (一 般 来 说 是 字符 串 、 图 像 及 URL) 放 在 数组 里 传 给 控制 器 束 好 了 ， 而 无 须 再 使 用 UIActivityltemSource 对 销 。 例 如 ， 用 下 面 这 行 代码 创建 出 
来 的 控制 器 ， 无 论 针对 何 种 操作 ， 都 只 会 返回 一 张 图 像 


UIActivityViewController *activity = [[UIActivityViewController alloc] 
initWithActivitylItems:@[imageView. image] 
applicationActivities:nil] ; 


这 种 直接 使 用 UIActivityViewController 的 方式 非常 简单 。 程 序 的 主 类 无 须 遵 循 UIActivityltemSource 协 议 ， 也 不 用 再 去 实现 其 他 方法 。 如 果 待 操作 的 数据 比较 简 
单 ， 那 融 可 以 用 这 种 便捷 的 方式 来 响应 各 种 操作 了 。 


待 操作 的 数据 未 必 只 能 有 一 份 。 在 activityltems 数 组 里 ， 我 们 还 可 以 添加 更 多 元 素 。 下 面 这 个 控制 器 会 根据 用 户 所 选 的 操作 类 型 ， 同 时 把 两 张 图 像 通 过 电子 邮件 
上 帮 出 ， 或 是 将 两 张 图 像 保 存 到 系统 的 Camera Roll 里 面 : 


UIImage *secondImage = [UIImage imageNamed:@"Default.png"] ; 

UIActivityViewController *activity = [[UIActivityViewController alloc] 
initWithActivityItems:G&[imageView.image, secondImage] 
applicationActivities:nil]; 


一 次 操作 多 份 数据 ， 可 以 令 用 户 更 有 效率 地 使 用 程序 。 


11.4.5 ”添加 分 享 服务 


每 个 程序 都 可 以 继承 UIActivity 的 子 类 ， 并 在 初始 化 UIActivityController 的 时 候 ， 将 该 类 的 对 象 传 过 去 ， 以 便 提 供应 用 程序 特有 的 操作 。 这 种 自 定 义 的 操作 ， 也 会 
和 系统 提供 的 操作 一 起 出 现在 活动 视图 控制 器 里 面 。 用 户 选择 某 个 自 定义 的 操作 之 后 ， 它 融会 展示 出 视图 控制 器 ， 使 得 用 户 可 以 与 传 过 去 的 数据 进行 交互 ， 或 以 某 种 
方式 使 用 相关 的 服务 ， 比 如 输入 密码 或 操控 数据 等 。 


程序 清单 11-1 实 现 了 一 份 模板 式 的 UIActivity 子 类 ， 它 能 够 展示 一 套 简单 的 文本 视图 界面 。 图 11-5 演 示 了 该 程序 所 特有 的 操作 ， 它 在 图 中 以 “list 

Items (Cookbook) ”图 标 来 表示 。 当 用 户 点 击 此 图 标 时 ， 程 序 就 会 展示 出 自 定义 的 视图 控制 器 ， 这 个 控制 器 的 界面 上 会 把 UIActivityController 传 给 它 的 各 条 数据 都 
列 出 来 。 它 会 列 出 每 项 数据 的 类 及 其 描述 信息 。 这 个 视图 控制 器 里 含有 一 段 处 理 代码 ， 当 用 户 按 下 Done 按 钮 时 ， 它 会 调用 activityDidFinish; 方法 ， 以 便 更 新 
UIActivity 实 例 。 
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程序 清单 11-1 实现 应 用 程序 自 定义 的 操作 


// All activities present a view controller. This custom controller 
// provides a full-sized text view. 
Ginterface TextViewController : UIViewController 
@property (nonatomic, readonly) UITextView *textView; 
@property (nonatomic, weak) UIActivity *activity; 
@end 
@implementation TextViewController 


// Make sure you provide a done handler of some kind, such as this 
// or an integrated button that finishes and wraps up 

- (void) done 

{ 


[ activity activityDidFinish: YES] ; 


// Just a super-basic text view controller 
- (instancetype) init 


{ 


self = [super init]; 
if (self) 
{ 
_textView = [[UITextView alloc] init]; 


_textView.font = 
[UIFont fontWithName:@"Futura" size:16.0f]; 
_textView.editable = NO; 


[self.view addSubview: textView]; 
PREPCONSTRAINTS( textView); 
STRETCH VIEW(self.view,  textView); 


// Prepare a Done button 
self.navigationItem.rightBarButtonItem - 
BARBUTTON(G"Done", Gselector(done)); 


| 


return self; 


} 


@end 


// A custom activity subclass to display a list of source items 
@interface MyActivity : UIActivity 
@end 


@implementation MyActivity 


{ 


NSArray *items; 


// A unique type name 
- (NSString *)activityType 


return G"CustomActivityTypeListItemsAndTypes"; 
// The title listed on the controller 
- (NSString *)activityTitle 


return @"List Items (Cookbook) "; 


// A custom image that says "iOS" with a rounded rect edge 
- (UIImage *)activityImage 
| 
CGReet rečt = CGRectMake(0.0£, O.DT, 75.0rf, 75.05); 
UIGraphicsBeginImageContext (rect.size); 
rect = CGRectInset(rect, 15.0f, 15.0f); 
UIBezierPath *path - [UIBezierPath 
bezierPathWithRoundedRect:rect cornerRadius:4.0f] ; 
[path stroke] ; 
rect = CGRectInset(rect, 0.0f, 10.0f); 
NSMutableParagraphStyle * paragraphStyle = 
[{NSMutableParagraphStyle alloc] init]; 
paragraphStyle.lineBreakMode = NSLineBreakByWordWrapping; 
paragraphStyle.alignment = NSTextAlignmentCenter; 
NSDictionary * attributes = 
@{NSParagraphStyleAttributeName : paragraphStyle, 
NSFontAttributeName : [UIFont fontWithName:@"Futura" 
5ize:18.0f])J; 
[g"iOS" drawInRect:rect withAttributes:attributes]; 
UIImage *image = UIGraphicsGetImageFromCurrentImageContext (); 
UIGraphicsEndImageContext () ; 


return image; 


// Specify if you can respond to these items 
- (BOOL)canPerformWithActivityItems: (NSArray *)activityItems 


return YES; 


// Store the items locally for later use 
- (void)prepareWithActivityItems: (NSArray *)activityItems 


{ 


items = activityItems; 


// Return a view controller, in this case one that lists 
// its items and their classes 
- (UIViewController *)activityViewController 


| 


TextViewController *tvc - [[TextViewController alloc] init]; 
tvc.activity - self; 
UITextView *textView = tvc.textView; 


NSMutableString *string - [NSMutableString string]; 
for (id item in items) 
[string appendFormat: 
@"$@: ¢@\n", [item class], [item description]]; 
textView.text - string; 


// Make sure to provide some kind of done: handler in 

// your main controller. 

UINavigationController *nav - [[UINavigationController alloc] 
initWithRootViewController:tvc]; 


return nav; 


| 


@end 


一 定 要 添加 一 种 令 分 享 操作 得 以 结束 的 方式 ， 当 控制 器 不 会 自行 终止 的 时 候 ， 更 要 注意 这 个 问题 。 把 数据 上 传 到 FTP 服 务 器 时 ， 开 妈 者 会 知道 上 传 操 作 何 时 结束 。 
把 信息 上 友 布 到 Twitter 时 ， 开 上 友 者 也 会 知道 信息 到 底 贴 上 去 了 没有 。 然 而 本 例 却 需要 由 用 户 来 决定 该 操作 应 该 在 什么 时 候 结束 。 视 图 控制 器 里 面 要 设计 一 个 属性 ， 它 应 
该 是 指向 UIActivity 的 弱 引 用 ， 等 到 分 享 操作 结束 时 ， 我 们 可 以 通过 该 属性 向 UIActivity 友 送 activityDidFinish : 消息 。 


UIActivity 类 里 面 有 一 些 方法 是 必须 实现 的 ， 另 外 一 些 方法 则 是 可 选 的 。 开 发 者 应 该 实现 下 面 列 出 的 所 有 方法 ， 这 些 方 法 使 得 我 们 可 以 制作 出 应 用 程序 特有 的 操 
作 : 


- activityType 该 方法 返回 一 个 独特 的 字符 串 ， 用 于 描述 这 个 操作 的 类 型 。 此 字符 串 应 该 与 系统 所 提供 的 UIActivityTypePostIToFacebook 相 仿 。 也 就 是 说 ， 两 者 
的 命名 方式 应 该 类 似 。 字 符 串 指明 了 操作 的 类 型 以 及 它 要 做 的 事情 。 程 序 清 单 11-1 所 返回 的 字符 串 是 @"CustomActivityTypeListItemsAndTypes"， 它 描述 了 这 项 操作 的 功 


ab 
月 已 o 


- activityTitle 


该 方法 负责 提供 需要 显示 在 活动 视图 控制 器 里 的 文本 。 图 11-5 中 自 定义 的 那 段 文本 ， 就 是 由 该 方法 所 返回 的 。 在 描述 应 用 程序 自 定 义 的 操作 

时 ， 应 该 采用 主动 句 式 。 我 们 可 以 模仿 革 果 公司 的 做 法 ， 比 方 说 ，“Save to Camera Roll” (保存 到 Camera Roll) ~ “Print” (打印 ) . "Copy (复制 ) 等 。 开 发 者 所 
选 的 标题 ， 应 该 是 “IT Want tohttp://www.hzcourse.com/resource /readBook?path= /opentesources/teach_ebook /uncompressed/15137/OEBPS/Text/...” (我 想 要 …… ) 9A 
的 后 面 那 一 部 分 。 比 方 说 ， 可 以 是 “I Want to Print” (我 要 打印 ) 、 “IWanttoCopy (我 要 复制 ) , 或 是 本 例 所 使 用 的 “I Want to List Items" — (我 要 把 这 些 条 目 列 
出 来 ) 。 除 了 to 或 and 等 不 太 重 要 的 单词 之 外 ， 字 符 囊 里 的 其 他 单词 均 应 首 字母 大 写 。 


- activitylmage 


制 简单 的 图 案 。 


该 方法 返回 控制 器 所 使 用 的 图 像 。 控 制 器 会 把 开发 者 所 提供 的 图 像 转换 成 单 色 的 位 图 。 制 作 这 种 图 标的 时 候 ， 我 们 应 该 在 透明 的 背景 上 面 绘 


: canPerformWithActivityltems: 一 一 系统 会 用 该 方法 来 扫描 传 给 UIActivity 的 各 条 数据 。 如 果 程序 的 控制 器 可 以 处 理 某 条 数据 ， 那 么 该 方法 就 应 该 针对 这 条 数 
据 返 回 YES。 
prepareWithActivityltems: 一 一 开发 者 可 以 在 该 方法 中 保存 系统 传 入 的 数据 ， 以 便 稍 后 使 用 (在 本 例 中 ， 我 们 把 传 过 来 的 数据 保存 到 实例 变量 里 ) ， 也 可 以 


预先 对 数据 进行 必要 的 处 理 。 


activityViewController 一 一 该 方法 应 该 用 旱 前 传 入 的 那些 数据 返回 一 份 完全 初始 化 好 了 的 视图 控制 器 。 该 控制 器 将 会 自动 展示 给 用 户 ， 这 使 得 用 户 在 执行 相应 


的 操作 之 前 ， 能 够 先 在 界面 中 调整 某 些 选项 。 


添加 应 用 程序 自 定义 的 操作 ， 可 以 扩大 程序 所 能 处 理 的 数据 类 型 ， 同 时 还 能 把 这 些 功能 集成 到 系统 所 提供 的 界面 中 。 这 是 iOS 系 统 里 一 个 非常 强大 的 特性 。 它 使 得 
开发 者 能 够 把 功能 非常 强大 的 操作 同系 统 服 务 (例如 “复制 到 剪贴 板 ” 或 “保存 到 相册 ”等 ) 整合 起 来 ， 或 是 将 其 与 本 机 之 外 的 API 相 连通 ， 例 如 友 布 到 Facebook.、 
发 布 到 Twitter、 上 传 到 Dropbox、 上 传 到 FTP 等 。 


本 例 中 实现 的 操作 没有 那么 强大 ， 它 只 是 把 各 项 数据 简单 地 列 出 来 。 该 功能 其 实 完全 可 以 用 程序 内 的 普通 界面 来 实现 。 但 在 思考 “操作 ”这 一 概念 的 时 候 ， 应 该 
把 思维 跳 到 应 用 程序 乙 外 。 我 们 应 该 把 用 户 的 数据 同一 些 分 享 操作 或 处 理 操 作 联 系 起 来 ， 而 那些 操作 未 必 会 以 普通 的 GUI 形式 来 呈现 。 


11.4.6 与 各 种 数据 类 型 相对 应 的 操作 


用 户 能 够 在 每 条 数据 上 面 执行 什么 操作 ， 取 决 于 该 数据 的 类 型 。 表 11-1 列 出 了 美国 版 iPhone 手机 中 的 各 种 源 数 据 类 型 以 及 与 之 对 应 的 操作 。 


表 11-1 各 种 数据 类 型 所 对 应 的 操作 


源 数 据 系统 所 能 提供 的 操作 
NSString Message (通过 短信 发 送 )、Mail (通过 邮件 发 送 )、Twitter (发 布 至 Twitter), 
单个 字符 串 或 多 个 字符 串 Facebook (发 布 至 Facebook)、Copy (复制 ) 
NSAttributedString l l 

" Message, Mail, Twitter, Facebook, Copy 
审 属 性 的 字符 串 
UIImage Message, Mail, Twitter, Facebook, Save Image (保存 图 像 )、Assiegn to Contact 
单 张 图 像 (指定 给 联系 人 )、Copy、Print (打印 ) 
UIImage 
pre Message, Mail, Facebook, Save Image, Copy, Print 
gk AAR 
UICOlot C 
pil C^. ki 

Message, Mail, Twitter, Facebook, Add to Reading List ( YS Jill £ [5] i3é 91] Ze ) 

NSURL Copy. oH] assets-library: 格式 (scheme) AY URL 可 " 分 至 到 Facebook, 
URL KAA mailto: 格式 的 URL 可 以 分 享 到 Mail 程序 ， 采 用 sms: 格式 的 URL 可 以 


分 享 到 Message 程序 


(5 ) 
源 数据 系统 所 能 提供 的 操作 
UIPrintPageRenderer, 
UIPrintFormatter 及 Print 
UIPrintInfo 
NSDictionary 如 果 这 种 对 象 可 以 分 享 ， 那 么 系统 就 会 显示 出 分 享 对 象 所 用 的 操作 。 但 是 系统 
字典 IPAS SCH AA 


例如 AVAsset, NSData, NSArray, NSDate 及 NSNumber， 如 果 试 图 分 享 
这 些 数据 ， 那 么 系统 展示 出 来 的 视图 控制 带 将 会 是 空 日 的 

系统 会 把 每 项 数据 所 文 持 的 操作 类 型 汇总 起 来 (比方 说 ， 如 条 要 同时 操作 字 
各 种 类 型 的 多 项 数据 件 串 和 图 片 ， 那 么 系统 就 会 展示 出 Message、Mail、Twitter、Facebook、Save 
Image, Assign to Contact, Copy 及 Print) 


不 文 持 的 数据 类 型 


上 述 这 些 操作 会 随 着 语言 设 定 而 改变 。 我 们 在 接 下 来 的 解决 方案 中 会 看 到 ， 除 了 这 些 基本 类 型 之 外 ， 开 发 者 还 能 通过 预 此 控制 器 (preview controller) 来 支持 其 


他 类 型 : 


- iOS 4 Quick Look 框 架 把 活动 控制 器 与 文件 预览 + o 由 Quick Look 所 提供 的 活动 控制 器 可 以 打印 并 发 送 很 多 类 型 的 文档 。 用 户 也 可 以 在 某 些 类 型 的 文档 上 面 
执行 其 他 操作 。 


` 文档 交互 控制 器 (UlDocumentInteractionController, document interaction controller) 提供 了 “Openin…” 功 能 ， 使 得 用 户 能 够 在 应 用 程序 之 间 分 享 文件 。 这 个 控 
制 器 在 展示 文档 的 时 候 ， 既 可 以 把 各 种 操作 都 集成 到 一 份 “选项 菜单 ”里 面 ， 也 可 以 只 列 出 与 “Open in…” 有 关 的 操作 。 


11.4.7 ”排除 某 些 操作 


如 果 想 排除 某 些 操作 ， 那 么 可 以 将 这 些 操 作 放 在 一 份 列表 里 ， 并 设置 excludedActivity-Types 属 性 : 


UIActivityViewController *activity = 
[[UIActivityViewController alloc] 
initWithActivityItems:items 
applicationActivities:G&[appActivity]]; 
activity.excludedActivityTypes = &[UIActivityTypeMail]; 


11.5 ”解决 方案 : Quick Look 预 览 控制 器 


QLPreviewController 类 使 得 用 户 可 以 预览 很 多 类 型 的 文档 。 该 控制 器 文 持 文本 、 图 像 、PDF、RTF、iWork 文 件 、Microsoft Office 文 档 (Office 97 及 之 后 的 版 
本 ,包括 DOC、PPT、XLS 等 ) 以 及 CSV 文 件 。 开 发 者 提供 一 份 控制 器 所 支持 的 文件 ，Quick Look 控 制 器 残 会 把 它 展示 给 用 户 。 我 们 可 以 把 系统 提供 的 活动 视图 控制 
器 集成 进来 ， 令 用 户 可 以 像 图 11-6 这 样 把 正在 预览 的 文档 分 享 出 去 。 

开发 者 既 可 以 将 这 种 控制 器 推 入 导航 栈 ， 也 可 以 把 它 以 模 态 形式 直接 显示 出 来 。QLPreview-Controller 能 够 适应 这 两 种 用 法 。 解 决 方案 11-5 演 示 了 这 两 种 使 用 方 
mu 
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图 11-6 Quick Look 控 制 器 以 模 态 形式 呈现 ， 如 果 用 户 点 击 了 动作 按钮 ， 那 它 就 会 显示 出 图 中 这 幅 画面 。Quick Look 能 够 处 理 许多 类 型 的 文档 ， 它 使 得 用 户 能 够 先 看 到 
文档 内 容 ， 然 后 再 决定 执行 何 种 操作 


实现 Quick Look 功 能 


若 想 实 现 Quick Look， 只 需 完成 下 列 几 步 : 
1. 令 主 控制 器 类 遵从 QLPreviewControllerDataSource 协 议 。 


2. 实 现 numberoOfPreviewltemslnPreviewController: 及 previewController: previewltemAtlndex: 两 个 数据 源 方法 。 前 者 返回 待 预 览 的 条 目 数 量 。 后 者 返回 
给 定 索引 处 的 预览 条 目 。 

3. 预 必 条 目 要 遵循 QLPreviewltem 协 议 。 协 议 中 包含 两 个 必须 实现 的 属性 ， 一 个 是 预览 条 目的 标题 ， 另 一 个 是 该 条 目的 URL。 解 决 方案 11-5 所 创建 的 Quickltem 
类 遵从 了 QLPreviewltem 协 议 。 访 类 以 极其 简单 的 方式 提供 了 数据 源 万 法 所 需 的 数据 。 

满足 了 上 述 要 求 之 后 ， 我 们 可 以 在 代码 中 新 建 预览 控制 器 ， 设 置 其 数据 源 ， 然 后 把 它 展示 出 来 或 将 其 推 入 导航 栈 。 


解决 方案 11-5 “实现 Quick Look 功 能 


Ginterface QuickItem : NSObject <QLPreviewItem> 
Gproperty (nonatomic, strong) NSString *path; 
Gproperty (readonly) NSString *previewItemTitle; 
Gproperty (readonly) NSURL *previewItemURL; 

@end 


@implementation QuickItem 


// Title for preview item 
- (NSString *)previewItemTitle 


{ 


return [ path lastPathComponent] ; 


// URL for preview item 
- (NSURL *)previewItemURL 


{ 


return [NSURL fileURLWithPath: path]; 


} 


@end 


#define FILE PATH [NSHomeDirectory() \ 
stringByAppendingPathComponent:G"Documents/PDFSample.pdf"] 


@interface TestBedViewController : UIViewController 
<QLPreviewControllerDataSource> 


@end 


@implementation TestBedViewController 


(NSInteger)numberOfPreviewItemsInPreviewController: 
(QLPreviewController *)controller 


return 1; 


- (id <QLPreviewItem>) previewController: 
(OLPreviewController *)controller 
previewItemAtIndex: (NSInteger)index; 


QuickItem *item = [íQuickItem alloc] init]; 
item.path - FILE PATH; 
return item; 


// Push onto navigation stack 
- (void)push 
| 
QLPreviewController *controller = 
[[OLPreviewController alloc] init]; 
controller.dataSource - self; 
[self.navigationController 
pushViewController:controller animated:YES]; 


// Use modal presentation 
- (void)present 


{ 


QLPreviewController *controller = 


[[OLPreviewController alloc] init]; 
controller.dataSource - self; 
[self presentViewController:controller 
animated:YES completion:nil]; 


- (void) loadView 


| 


self.view = [[UIView alloc] init]; 
self.view.backgroundColor = [UIColor whiteColor] ; 


self .navigationItem.rightBarButtonItem = 
BARBUTTON (@"Push", @selector (push) ) ; 

self .navigationItem.leftBarButtonItem = 
BARBUTTON (@"Present", @selector (present) ) ; 


@end 


11.6 解决 万 案 : 使 用 文档 交互 控制 器 


UIDocumentlnteractionController 类 使 得 应 用 程序 可 以 向 用 户 展示 一 些 交 互 选项 ， 令 其 能 够 以 多 种 方式 来 使 用 文档 。 借 助 这 个 类 ， 用 户 可 以 享受 如 下 好 处 : 
由 iOS 系 统 所 提供 的 应 用 程序 间 文 档 分 享 功能 (也 就 是 “Open this document in…some app” ) o 

: 由 Quick Look 框 架 所 提供 的 文档 预览 能 力 。 

- 由 UIActivityViewController 所 提供 的 “打印 ”、“ 分 享 ” 以 及 “发 布 到 社交 网 站 ”等 操作 。 


本 章 前 面 在 讲解 活动 视图 控制 器 的 时 候 ， 已 经 演示 过 后 两 项 特性 了 。 无 论 在 样 狐 还 是 在 行为 上 面 ，UIDocumentlnteractionController 都 与 
UIActivityViewController 非 常 接近 。UIDocumentinteractionController 增 加 了 强大 的 程序 间 分 享 功 能 。 


UIDocumentlnteractionController 有 两 种 样式 ， 如 图 11-7 所 示 。 “Open in...” 样 式 只 提供 “Open in” iA. m “options” 样式 则 提供 一 份 包含 各 种 交互 选 
项 的 列表 ， 里 面 有 "Open in...” , Quick Look 以 及 系统 所 支持 的 其 他 操作 。 这 基本 上 相当 于 在 标准 的 动作 菜单 所 提供 的 功能 之 外 ， 又 加 进 了 “Open in...” Tae. 
发 者 需要 手工 添加 与 Quick Look 功 能 有 关 的 回调 ， 但 这 只 需 很 少 的 代码 即 可 实现 。 


11.6.1 创建 UIDocumentinteractionController 实 例 


每 个 UlIDocumentinteractionController 都 针对 一 份 特定 的 文件 。 该 文件 一 般 位 于 用 户 的 Documents 文 件 夹 中 ， 下 面 代 码 中 的 fileURL 束 代表 这 份 文件 : 


dic = [UIDocumentInteractionController 
interactionControllerWithURL:fileURL]; 
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图 11-7 AL AKRADSZ “Openin” AK5 “options” M444 ULDocumentInteractionController 


开 上 友 者 提供 指向 本 地 文件 的 URL， 然 后 用 “options” 风 格 (其 实 束 是 动作 菜单 ) Ek "Open in…” 风 格 将 控制 器 显示 出 来 。 我 们 可 以 用 两 种 万 式 来 显示 “选项 荣 
一 种 是 将 其 与 UIBarButtonltem 连 接 起 来 ， 另 一 种 是 将 其 显示 在 屏幕 上 的 某 块 失 形 区 域内 : 


- 
= 
- 


: presentOptionsMenuFromRect: inView: animated: 
: presentOptionsMenuFromBarButtonItem: animated: 
: presentOpenInMenuFromRect: inView: animated: 
: presentOpenInMenuFromBarButtonltem: animated: 


在 ijPad 上 面 ， 系 统 会 把 UIBarButtonltem 或 开发 者 所 传 入 的 rect 与 将 要 显示 的 popover 连 接 起 来 。 而 在 iPhone 上 ， 系 统 则 会 显示 一 份 模 态 的 控制 器 视图 。 正 如 大 
家 所 料 ，iPad 上 要 进行 更 多 的 处 理工 作 ， 因 为 用 户 可 能 会 点 击 导 航 栏 上 面 的 其 他 按钮 ， 也 可 能 会 关 掉 popover。 


等 iPad 显 示 出 相关 的 控制 器 之 后 ， 我 们 就 应 该 把 每 个 UlBarButtonltem 都 禁用 ， 然 后 等 控制 器 消失 之 后 ， 表 启用 它们 。 这 是 相当 重要 的 一 件 事 ， 因 为 我 们 肯定 不 
希望 用 户 重新 点 击 正在 使 用 中 的 UlBarButtonltem， 否 则 开发 者 又 要 处 理 另 外 一 个 popover 了 。 如 果 没 有 仔细 监控 好 按钮 的 状态 以 及 正在 显示 的 popover， 那 就 会 遭 
遇 很 多 知 炊 的 情况 。 解 决 方案 11-6 防 学 了 这 些 情况 。 


解决 方案 11-6 ”使 用 UlIDocumentinteractionController 


@implementation TestBedViewController 


| 


NSURL *fileURL; 
UIDocumentInteractionController *dic; 
BOOL canOpen; 


Hpragma mark QuickLook 
- (UIViewController *) 
documentInteractionControllerViewControllerForPreview: 
(UIDocumentInteractionController *)controller 


return self; 


- (UIView *)documentiInteractionControllerViewForPreview: 


(UIDocumentInteractionController *)controller 


return self.view; 


(CGRect)documentInteractionControllerRectForPreview: 
(UIDocumentInteractionController *)controller 


return self.view.frame; 


#pragma mark Options / Open in Menu 


// Clean up after dismissing options menu 
- (void)documentInteractionControllerDidDismissOptionsMenu: 
(UIDocumentInteractionController *)controller 


self.navigationItem.leftBarButtonItem.enabled - YES; 
Sie = Sl 


// Clean up after dismissing open menu 
- (void) documentInteractionControllerDidDismissOpenInMenu: 
(UIDocumentInteractionController *)controller 


self .navigationItem.rightBarButtonItem.enabled = canOpen; 
Gic = nil; 


// Before presenting a controller, check to see if there's an 
// existing one that needs dismissing 
- (void) dismissIfNeeded 


{ 
if (dic) 


[dic dismissMenuAnimated: YES] ; 
self.navigationItem.rightBarButtonItem.enabled = canOpen; 
self.navigationlItem.leftBarButtonItem.enabled = YES; 


// Present the options menu 


- (void)action: (UIBarButtonItem *)bbi 
{ 
[self dismissIfNeeded]; 
dic - [UIDocumentInteractionController 
interactionControllerWithURL:fileURL]; 
dic.delegate - self; 
self .navigationItem.leftBarButtonItem.enabled = NO; 
[dic presentOptionsMenuFromBarButtonItem:bbi animated: YES] ; 


// Present the open-in menu 
- (void)open: (UIBarButtonItem *)bbi 
{ 
[self dismissIfNeeded]; 
dic = [UIDocumentInteractionController 
interactionControllerWithURL:fileURL]; 
dic.delegate - self; 
self.navigationlItem.rightBarButtonItem.enabled = NO; 
[dic presentOpenlInMenuFromBarButtonItem:bbi animated:YES]; 


#pragma mark Test for Open-ability 
- (BOOL)canOpen: (NSURL *)aFileURL 


UIDocumentInteractionController *tmp - 

[UIDocumentInteractionController 
interactionControllerWithURL:aFileURL] ; 

BOOL success = 
[tmp presentOpenInMenuFromRect:CGRectMake(0,0,1,1) 
inView:self.view animated:NO]; 

[tmp dismissMenuAnimated:NO] ; 

return success; 


- (void) viewDidAppear: (BOOL) animated 


[super viewDidAppear:animated] ; 

// Only enable right button if the file can be opened 
canOpen = [self canOpen:fileURL] ; 
self.navigationItem.rightBarButtonItem.enabled = canOpen; 


#pragma mark View management 
- (void) loadView 
{ 
self.view = [{UIView alloc] init]; 
self.view.backgroundColor = [UIColor whiteColor] ; 
self.navigationItem.rightBarButtonItem = 
BARBUTTON (@"Open in...", Gselector(open:)); 
self .navigationiItem.leftBarButtonItem = 
SYSBARBUTTON (UIBarButtonSystemItemAction, 


Gselector(action:)); 


NSString *filePath - [NSHomeDirectory() 
stringByAppendingPathComponent :@"Documents/DICImage.jpg"] ; 
fileURL = [NSURL fileURLWithPath:filePath]; 


| 


@end 


11.6.2 UlDocumentinteractionController 的 属性 


每 个 UIDocumentinteractionController 都 提供 了 若干 属性 ， 这 些 属性 可 以 在 控制 器 的 委托 回调 方法 里 使 用 : 
- URL 一 一 开发 者 可 通过 该 属性 查 出 控制 器 正在 服务 于 哪 份 文件 。 这 个 URL 与 创建 控制 器 时 所 传 入 的 URL 相 同 。 


- UTI 


该 属性 用 来 决定 哪些 应 用 程序 可 以 打开 此 文档 。 它 会 根据 文件 名 及 元 数据 ， 用 本 章 早 前 提 到 的 系统 函数 来 找 出 与 之 最 匹配 的 UTI。 开 发 者 可 在 代码 中 手 
工 设置 该 属性 ， 以 履 盖 由 系统 所 提供 的 值 。 


. name 一 一 该 属性 对 应 于 URL 中 的 最 后 一 个 “路 径 组 件 ”， 这 使 得 开发 者 无 须 手 工 截 取 URL， 即 可 获取 到 用 户 可 以 看 懂 的 名 称 。 
. icons 一 一 该 属性 可 用 来 获取 与 当前 文件 类 型 相对 应 的 图 标 。 应 用 程序 在 声明 自己 所 能 支持 的 文件 类 型 时 ， 可 以 提供 相关 的 图 像 链接 (11.7 节 会 讲 到 这 个 问 


题 ) 。 这 些 图 像 对 应 于 由 kUTTypelconFileKey 键 所 指 的 值 ， 本 章 前 面 曾经 提 到 过 kUTTypelconFileKey。 


- annotation 一 一 开发 者 可 以 通过 该 属性 给 将 要 打开 此 文件 的 那个 应 用 程序 传递 一 些 自 定义 的 数据 。 这 个 属性 没有 标准 的 用 法 ， 不 过 它 必须 是 属性 列表 式 的 顶级 
对 象 ， 也 就 是 说 ， 它 必须 是 NSDictionary、NSArray、NSData、NSStringe、NSNumber 或 NSDate。 由 于 不 同 的 开发 者 之 间 没 有 形成 一 套 标 准 ， 所 以 使 用 该 属性 的 场合 不 太 
多 ， 除 非 是 一 群 开发 者 在 他 们 自己 设计 的 一 组 应 用 程序 中 借 此 分 享 信息 。 


11.6.3 ”提供 快速 查看 文档 的 功能 


在 委托 中 实现 下 列 三 个 回调 方法 ， 即 可 为 控制 器 添加 Quick Look 功 能 : 


Hpragma mark QuickLook 
- (UIViewController *) 
documentInteractionControllerViewControllerForPreview: 
(UIDocumentInteractionController *)controller 


return self; 


(UIView *)documentInteractionControllerViewForPreview: 
(UIDocumentInteractionController *)controller 


return self.view; 


(CGRect)documentInteractionControllerRectForPreview: 
(UIDocumentInteractionController *)controller 


return self.view.frame; 
上 面 这 些 方法 分 别 用 来 指定 展示 预览 田 面 的 视图 控制 器 、 预 览 男 面 所 在 的 视图 ， 以 及 预览 画面 的 frame 尺 寸 。 对 于 平板 电脑 来 说 ， 在 个 别 情况 下 ， 我 们 可 能 需要 用 


子 视图 控制 器 把 预 抱 画面 显示 到 屏幕 中 的 某 一 部 分 里 (比方 说 ， 在 使 用 分 栏 视 图 的 时 候 ， 我 们 就 希望 预 唤 画面 只 占据 一 部 分 屏幕 空间 ) ， 但 对 于 iPhone 来 说 ， 基 本 上 
BENZ S RAH oie T BER. 


11.6.4 ”判断 是 否 应 局 用 “Open in...” $E 
使 用 UIDocumentlnteractionController 的 时 候 ，Options 菜 单 里 面 几乎 总 是 会 列 出 有 效 的 选项 。 在 实现 了 Quick Look 功 能 所 需 的 回调 方法 之 后 ， 更 是 如 此 。 但 
是 ， 我 们 不 一 定 能 找到 “Open in...” 选 项 。 该 选项 取决 于 开发 者 提供 给 控制 器 的 文件 数据 ， 以 及 用 户 在 设备 中 所 安装 的 应 用 程序 。 


如 果 用 尸 安 和 在 设备 上 的 程序 无 法 打开 控制 器 中 的 这 种 文档 ， 那 么 融会 碰 到 没有 合适 的 “Open in…” 操 作 可 供 执行 的 情况 。 这 可 能 是 由 于 文件 类 型 比较 奇怪 ， 但 
一 般 来 说 ， 还 是 由 于 用 户 没 有 购买 并 安装 相应 的 程序 。 在 使 用 iOS 模 拟 器 运行 程序 时 ， 经 常会 遇 到 这 种 情况 。 


开发 者 总 是 应 该 检查 一 下 是 否 需 要 提供 “Open in...” 菜 单项 。 解 决 方案 11-6 用 了 一 个 非常 筑 的 办 法 来 判断 是 否 有 其 他 应 用 程序 能 够 显示 并 编辑 URL 中 的 文件 。 具 
体 做 法 是 : 创建 临时 控制 器 ， 并 试 着 用 它 来 展示 该 文件 。 如 果 成 功 ， 就 表示 有 程序 能 够 打开 此 文件 ， 并 且 该 程序 已 经 安装 在 设备 上 上 了。 若是 失败 ， 则 说 明 并 没有 这 样 
的 程序 ， 此 时 我 们 应 该 禁用 “Open in...” 按 钮 。 


对 于 iPad 来 说， 开 友 者 必须 在 viewDidAppear: 中 或 在 它 之 后 执行 此 检测 ， 也 就 是 说 ， 必 须 等 视窗 建 起 来 之 后 才能 进行 检测 。 把 临时 控制 器 展示 出 来 之 后 ， 我 们 
立刻 融 将 其 天 朵 了 ， 而 且 也 没有 使 用 动画 效果 ， 所 以 终端 用 户 是 不 会 友 现 它 的 。 


这 种 实现 方式 显然 不 够 优雅 ， 但 它 却 能 在 展示 程序 界面 或 使 用 一 种 新 文件 之 前 ， 首 先 判断 出 设备 里 有 没有 别 的 程序 能 打开 它 。 读 者 可 以 通过 
bugreporter.apple.com 向 苹果 公司 提交 改进 建议 。 


还 有 一 点 要 注意 : 这 种 测试 技巧 在 解决 方案 11-6 这 样 的 主 视图 上 面 是 可 行 的 ， 但 对 于 iPad 中 某 些 非 标准 的 popover 界 面 来 说 ， 它 可 能 还 是 有 些 间 题 。 


Qi 在 同一 个 应 用 程序 里 ， 我 们 很 少 会 同时 给 用 户 提供 “选项 菜单 ”及 “Openin… 按钮 。 解 决 方案 11-6 采 用 系统 自 带 的 动作 图 标 来 表示 选项 菜单 。 如 果 程 
这 只 给 用 户 提供 各 种 “Open in…” 操作 ， 而 不 提供 选项 菜单 ， 那 么 就 可 以 用 该 图 标 来 表示 那些 操作 ， 而 无 须 再 使 用 解决 方案 11-6 中 的 “Open in… 文字 按钮 了 。 


11.7， 解 决 方案 : 声明 程序 所 支持 的 文档 类 型 


应 用 程序 里 的 文档 并 不 局 限于 程序 本 身 所 创建 的 那些 文件 ， 也 不 局 限于 它 从 网 上 下 载 的 那些 文件 。 在 解决 方案 11-6 中 我 们 已 经 看 到 : 程序 可 以 处 理 某 些 特定 类 型 
的 文件 。 它 们 可 以 打开 由 其 他 程序 所 友 过 来 的 文件 。 在 本 章 前 面 的 内 容 里 ， 我 们 站 在 上 友 送 者 的 角度 讲解 了 文档 分 享 功能 ， 并 告诉 大 家 怎样 用 控制 器 的 “Open in...” 3 
项 把 文件 导出 给 其 他 应 用 程序 。 而 现在 ， 我 们 则 要 站 在 接收 者 的 角度 来 看 待 文档 分 享 功能 。 


应 用 程序 可 在 其 Info.plist 属 性 列表 中 声明 它 所 支持 的 文件 类 型 。Launch Services 系 统 会 读 取 这 些 数据 ， 并 创建 出 文件 类 型 与 程序 之 间 的 对 应 关系 ， 以 供 


UIDocument-InteractionController({# A, 


开发 者 可 以 直接 编辑 属性 列表 ， 不 过 Xcode 的 Project>Target>Info 界 面 提供 了 一 种 更 为 简单 的 方式 。 打 开 Custom iOS Target Properties FHAYDocument 
Types 区 域 。 点 击 “+” 按 钮 ， 即 可 添加 应 用 程序 所 支持 的 文档 类 型 。 图 11-8 演 示 了 如 何 用 该 界面 来 声明 本 程序 支持 JPEG 图 像 文 档 。 


Document Types (1) 


Name | jpeg 


Types | public.jpeg 
specified 


Icon 


Add icons 


=a EE 
w Additional document type properties (1) 


F i Li i 
rs C y Y Lä | Li E 


LSHandlerRank = Alternate 


图 11-8 ”在 Xcode 的 Target>Info 界 面 中 声明 程序 所 支持 的 文档 类 型 


声明 文档 类 型 的 时 候 ， 应 该 提供 下 面 三 种 信息 : 


名 称 开发 者 必须 指定 名 称 ， 但 其 内 容 可 以 是 任意 值 。 它 应 该 描述 当前 文档 类 型 ， 然 而 目前 OS 并 未 使 用 该 字段 ， 它 可 能 会 用 在 以 后 的 OS 系统 里 。 这 个 字段 
在 Macintosh 上 面 或 许 更 有 用 (Mac 系统 的 Findet 程 序 会 将 其 视 为 “kind” 字 符 串 ) ， 不 过 ， 开 发 者 还 是 必须 指定 它 。 


. 一 个 或 多 个 UTI 一 一 为 当前 类 型 指定 一 个 或 多 个 UTI。 本 例 只 指定 了 public.jpeg。 如 果 有 多 个 UTI， 就 用 去 号 将 其 隔 开 。 比 方 说 ， 我 们 可 以 声明 一 种 image 文 档 类 
型 ， 它 对 应 于 public.jpeg、public.tif 及 public.png 三 种 UTI。 若 想 把 程序 能 够 支持 的 文件 类 型 限定 得 严格 一 些 ， 那 就 使 用 具体 的 类 型 。 虽 说 public.image 可 以 涵盖 上 述 三 种 
类 型 ， 但 这 样 做 可 能 会 使 程序 支持 它 本 来 不 该 支持 的 图 像 类 型 。 


- 处 理 程序 级 别 Launch Services 的 处 理 程序 级 别 ， 描 述 了 当前 程序 在 能 够 打开 该 类 型 文档 的 所 有 程序 之 中 处 于 和 何 种 地 位 。 如 果 是 Ownetr， 就 表明 本 程序 是 创建 
这 种 文件 的 原生 程序 。 若 像 图 11-8 一 样 把 值 设 为 Alternate， 则 表明 该 程序 只 是 充当 这 种 文档 的 辅助 查看 器 。 开 发 者 需要 在 Additional document type ptopetties 区 域 手工 添加 


LSHandlerRank 键 。 


开发 者 也 可 以 指定 图 标 文件 。 这 些 文件 在 OS X 系 统 中 会 用 作文 档 的 图 标 ， 但 是 在 iOs 系 统 中 的 用 途 却 不 大 。 唯 一 会 出 现 图 标的 情况 ， 就 是 在 iTunes 里 面 使 用 File 
Sharing 来 添加 及 删除 文件 时 ，iTunes 会 把 程序 图 标 列 在 Apps 分 页 中 。 图 标 一 般 是 320x320 (UTTypeSize320lconFile) 及 64x64 (UTTypeSize64lconFile) 大 小 ， 
而 且 通 常 仅 限 于 程序 能 够 创建 的 文件 或 是 程序 为 其 定义 了 自 定义 类 型 的 文件 。 


Xcode 会 根据 开发 者 在 上 述 交 互 式 界面 里 设置 的 数据 ， 在 程序 的 Info.plist 之 中 构建 一 个 CFBundleDocumentTypes 数 组 。 图 11-8 中 的 配置 会 在 Info.plist 里 产生 下 
面 这 段 代 码 : 


<key>CFBundleDocumentTypes</key> 
<array> 
<dict> 
«key»CFBundleTypeIconFiles«/key» 
<array/> 
<key>CFBundleTypeName</key> 
<string>jpg</string> 
<key>LSHandlerRank</key> 
<string>Alternate</string> 
<key>LSItemContentTypes</key> 
<array> 
<string>public.jpeg</string> 
</array> 
</dict> 
</array> 


11.7.1 创建 目 定义 的 文档 类 型 


如 果 程 序 构建 了 新 类 型 的 文档 ， 那 么 开发 者 应 该 在 Target>1Info 编 辑 器 界面 的 Exported UTIs 区 域 中 声明 这 些 类 型 ， 如 图 11-9 所 示 。 这 样 做 相当 于 向 系统 注册 了 这 
种 文件 类 型 ， 并 使 得 系统 可 以 把 本 程序 视 为 该 类 型 的 拥有 者 。 


Y Exported UTIs (1) 


Cookbook 


Description | Cookbook | Small Icon  Cover- 64 
Identifier com.sadun.cookbookfile | Large Icon | Cover- 320 x 


Conforms To | public.text | 


¥ Additional exported UTI properties (1) 
Key Type Value 
Y UTTypeTagSpecification ,. Dictionary (1 item) 
public.filename-extension String cookbook 


图 11-9 在 “Target>Info” 编 辑 器 界面 的 “Exported UTIs” 区 域 中 声明 程序 自 定义 的 文件 类 型 


定义 新 类 型 的 时 候 ， 应 该 提供 自 定 义 的 UTI (本 例 中 是 com.sadun.cookbookfile) 、 文 档 图 标 (64x64 与 320x320 大 小 ) ， 以 及 能 够 表示 文件 类 型 的 文件 扩展 
名 。 与 声明 程序 所 支持 的 文档 类 型 一 样 ，Xcode 也 会 向 项 目的 Info.plist 文 件 中 导出 一 份 数组 。 图 11-9 中 的 配置 将 会 产生 下 面 的 代码 : 


<key>UTExportedTypeDeclarations</key> 
<array> 
<dict> 
<key>UTTypeConformsTo</key> 
<array> 
<string>public.text</string> 
</array> 
<key>UTTypeDescription</key> 
«string»Cookbook«/string» 
«key»UTTypeIdentifier«/key» 
«string»com.sadun.cookbookfile«/string» 
<key>UTTypeSize320IconFile</key> 
<string>Cover-320</string> 
«key»UTTypeSize64IconFile«/key» 
<string>Cover-64</string> 
<key>UTTypeTagSpecification</key> 
<dict> 
«key»public.filename-extensionc/key» 
«string»cookbook«/string» 
</dict> 
</dict> 


</array> 


如 果 把 上 述 配 置 添 加 到 自己 的 项 目 中 ， 那 么 你 的 程序 就 可 以 用 com.sadun.cookbookfile 类 型 的 UTI 打 开 扩 展 名 为 cookbook 的 文件 了 。 


1 


— 


.7.2 ”实现 对 文档 的 支持 


应 用 程序 对 文档 提供 支持 的 时 候 ， 应 该 在 每 次 处 于 活动 状态 时 检查 Inbox 文 件 夹 : 


- (void)applicationDidBecomeActive: (UIApplication *)application 


| 


// perform inbox test here 


我 们 应 该 判断 Documents 文 件 夹 下 面 有 没有 出 现 Inbox 文 件 夹 。 如 果 有 ， 就 应 该 把 Inbox 里 面 的 内 容 移 到 适当 的 位 置 上 ， 一 般 来 说 ， 应 该 移 到 主 Documents 目 录 
下 。 清 空 Inbox 之 后 ， 就 删 掉 它 。 这 样 做 可 以 提升 用 户 体验 ， 尤 其 是 在 使 用 iTunes 来 分 享 文件 时 ， 不 会 令 用 户 对 Inbox 文 件 夹 和 它 的 作用 感到 困惑 。 


把 文件 移 到 Documents 的 时 候 ， 要 判断 待 移动 的 文件 名 是 否 与 Documents 中 已 有 的 文件 相 ; 中 突 ， 如 果 重 名 ， 那 就 改 用 另 一 个 名 字 (一 般 来 说 ， 会 在 原名 称 后 面 加 
连 字符 ， 然 后 再 跟 个 数字 ) ， 以 免 纤 写 了 现 有 的 文件 。 解 决 方案 11-7 会 根据 目标 路 径 寻 找 可 供 使 用 的 文件 名 。 如 果 尝 试 了 一 干 次 之 后 还 找 不 到 合适 的 名 称 ， 那 就 放弃 
此 文件 。 正 常情 况 下 用 户 不 会 产生 那么 多 份 重 名 的 文档 。 若 真是 那样 ， 则 说 明 应 用 程序 的 设计 有 严重 缺陷 。 


解决 方案 11-7 ”处 理 传 入 的 文档 


#define DOCUMENTS PATH  [NSHomeDirectory() \ 
stringByAppendingPathComponent :@"Documents"] 

#define INBOX PATH [DOCUMENTS PATH N 
stringByAppendingPathComponent :@"Inbox"] 


@implementation InboxHelper 
+ (NSString *)findAlternativeNameForPath: (NSString *)path 
NSString *ext = path.pathExtension; 


NSString *base - [path stringByDeletingPathExtension]; 
tor (int i = 1; i « 999; i++) 
NSString *dest - 
(NSString stringWithFormat :@"%@-%d.%@", base, i, ext]; 


// if the file does not yet exist, use this destination path 
if (![[NSFileManager defaultManager] 

fileExistsAtPath:dest]) 

return dest; 


NSLog(G"Exhausted possible names for file $06. Bailing.", 
path.lastPathComponent); 
return nil; 


- (void)checkAndProcessInbox 
( 
// Does the Inbox exist? If not, we're done 
BOOL isDir; 
if (![[NSFileManager defaultManager] 
fileExistsAtPath:INBOX PATH isDirectory:&isDir] ) 
return; 


NSError *error; 
BOOL success; 


// If the Inbox is not a folder, remove it 


1f (igepir) 
success = [(NSFileManager defaultManager] 
removeItemAtPath:INBOX PATH error:&error]; 
if (!success) 


NSLog(G"Error deleting Inbox file (not directory): %@", 
error.localizedFailureReason) ; 
return; 


// Retrieve a list of files in the Inbox 

NSArray *fileArray - [[NSFileManager defaultManager] 
contentsOfDirectoryAtPath:INBOX PATH error:&error]; 

if (!fileArray) 

{ 
NSLog(G"Error reading contents of Inbox: %@", 
error.localizedFailureReason) ; 

ferurm 


// Remember the number of items 
NSUInteger initialCount = fileArray.count; 


// Iterate through each file, moving it to Documents 
for (NSString *filename in fileArray) 
{ 
NSString *source = [INBOX PATH 
stringByAppendingPathComponent: filename] ; 
NSString *dest = [DOCUMENTS PATH 
stringByAppendingPathComponent:filename]; 


// Is the file already there? 
BOOL exists - 

[[NSFileManager defaultManager] fileExistsAtPath:dest]; 
if (exists) dest - [self findAlternativeNameForPath:dest]; 
if (!dest) 

{ 

NSLog(G"Error. File name conflict not resolved"); 

continue; 


// Move file into place 


success - [[NSFileManager defaultManager] 
moveltemAtPath:source toPath:dest error:&error]; 
if (!success) 


{ 


NSLog(@"Error moving file from Inbox: %@", 
error.localizedFailureReason) ; 
continue; 


// Inbox should now be empty 
fileArray = [[NSFileManager defaultManager] 
contentsOfDirectoryAtPath: INBOX PATH error:&error]; 
if (!fileArray) 
{ 
NSLog(G"Error reading contents of Inbox: %@", 
error.localizedFailureReason) ; 
return; 


if (fileArray.count) 


| 


NSLog(@"Error clearing Inbox. $d items remain", 
fileArray.count); 


return; 


// Remove the inbox 
success = [[NSFileManager defaultManager] 
removeItemAtPath:INBOX PATH error:&errorl; 


if (!success) 


NSLog(G"Error removing inbox: %@", 
error.localizedFailureReason); 


return; 


NSLog(G"Moved $d items from the Inbox", initialCount); 


| 


@end 


解决 方案 11-7 会 逐个 扫描 Inbox 目 录 里 的 文件 ， 并 将 其 移 走 。 它 会 在 清空 Inbox 目 录 之 后 把 该 目录 删除 。 正 如 大 家 所 见 ， 这 些 方法 会 频繁 使 用 与 File 
Manager (NSFileManager， 文 件 管理 器 ) 有 天 的 功能 。 这 么 做 主要 是 为 了 把 任务 执行 过 程 中 可 能 出 错 的 各 种 情况 都 处 理 好 ， 以 免 干扰 程序 运行 。 如 果 Inbox 里 面 都 
是 小 文件 ， 那 么 对 这 些 文件 的 处 理应 该 很 快 束 能 完成 。 但 如 果 要 处 理 视频 或 音频 等 大 文件 ， 那 束 应 该 在 自己 的 操作 队列 上 完成 此 任务 了 。 


程序 如 果 要 支持 public.data 类 型 的 文件 (也 就 是 说 ,程序 想 要 打开 任意 类 型 的 文件 ) ， 那 么 可 能 需要 使 用 UIWebView 实 例 来 显示 这 些 文件 。 (Technical Q&A 
QA1630) (http://developer.apple.com/library/ios/#qa/qa1630) 详细 列 出 了 iOS 系 统 在 这 种 视图 里 面 可 以 显示 以 及 不 能 显示 的 文件 类 型 。 除 了 可 以 显示 简单 的 
HTML 以 外 ，UIWebView 还 能 展示 大 多 数 音频 及 视频 文件 ， 以 及 Excel、Keynote、Numbers、Pages、PDF、PowerPoint、Word 等 文件 。 


11.8 解决 方案 : 创建 基于 URL 的 服务 


苹果 公司 内 置 的 应 用 程序 提供 了 很 多 可 以 通过 URL 来 调用 的 服务 。 开 发 者 可 以 用 Safari 来 开启 网 页 、 用 Maps 来 显示 地 图 ， 或 通过 mailto: 格式 的 URL 启 动 Mail 程 
序 ， 以 展示 编写 邮件 的 界面 。URL 模 式 融 是 URL 开 头 的 那 一 部 分 ， 也 融 是 出 现在 冒号 前 的 字符 ， 比 方 说 http 或 ftp。 


这 些 服务 之 所 以 能 够 运作 ， 是 因为 IOS 系 统 知道 如 何 把 URL 模 式 与 应 用 程序 对 应 起 来 。 以 http: 开 头 的 URL 会 用 Mobile Safari 来 打开 。 而 以 mailto: 开头 的 URL 则 会 
转向 Mail 程 序 。 有 些 读者 也 许 不 知道 : 我 们 可 以 定义 自己 的 URL 模 式 ， 并 在 应 用 程序 里 面 实 现 它们 。 并 非 所 有 的 标准 模式 都 受 iO9S 系 统 支持 ， 例 如 FTP 模 式 就 无 法 使 
用 。 


自 定 义 的 模式 使 得 应 用 程序 能 够 以 Mobile Safari 或 男 一 个 程序 来 打开 那 种 类 型 的 URL。 比 方 说 ， 如 果 程 序 注册 了 xyz， 那 么 以 xyz: 开头 的 链接 就 会 交 由 该 程序 来 
处 理 ， 系 统 会 把 链接 传 给 应 用 程序 委托 的 application: openURL: sourceApplication: annotation: 方法 。 不 过 ， 我 们 并 不 需要 在 那个 方法 里 面 专门 编写 代码 。 如 
果 开 发 者 只 是 想 启 动 应 用 程序 ， 那 么 把 模式 添加 到 程序 里 面 就 可 以 了 ， 系 统 会 在 打开 相关 类 型 的 URL 时 ， 自 动 实现 程序 间 的 跳 转 。 


通过 处 理 程序 ， 我 们 可 以 在 系统 跳 转 到 本 程序 的 时 候 对 传 入 的 URL 做 一 些 处 理 。 比 方 说 ， 可 以 打开 某 个 特定 的 数据 文件 、 获 取 某 个 特定 的 名 称 、 显 示 某 张 图 像 ， 或 
是 处 理 包 含 在 调用 中 的 某 些 信息 。 


11.8.1 ”声明 模式 


Target>lnfo 编 辑 界面 的 URL Types 区 域 列 出 了 程序 自 定义 的 URL 模 式 ， 开 友 者 可 以 在 这 里 声明 URL 模 式 ， 如 图 11-10 所 示 。 图 中 所 声明 的 模式 将 会 在 Info.plist 里 
面 产生 下 列 代 码 : 


<key>CFBundleURLTypes</key> 
<array> 
<dict> 
<key>CFBundleURLName</key> 
<string>com.sadun.urlSchemeDemonstration</string> 
<key>CFBundleURLSchemes</key> 
«array» 
<string>xyz</string> 
</array> 
</dict> 


</array> 


Y URL Types (1) 


com.sadun.urlSchemeDemonstration 


Identifier  com.sadun.urlSchemeDemonstration URL Schemes | xyz 


Icon | None ¥ Role | Editor 


kb Additional url type properties (0) 


图 11-10 ”在 Tarpget>Info 编 辑 界 面 的 URL Types EX 3i "P Ae A Z GLAS URLASE XX, 


名 为 CFBundleURLTypes 的 条 目 中 包含 了 一 份 由 字典 所 构成 的 数组 ， 用 来 表述 程序 所 能 打开 并 处 理 的 URL 类 型 。 每 份 字典 都 相当 简单 ， 里 面包 含 了 两 个 键 : 一 个 
是 CFBundleURLName， 用 来 表示 开发 者 所 指定 的 标识 符 ; 另 一 个 是 CFBundleURLSchemes， 用 来 表示 URL 模 式 数组 。 


模式 数组 列 出 了 属于 这 个 抽象 标识 符 的 一 系列 URL 前 缀 。 开 发 者 可 以 添加 一 个 或 多 个 模式 。 本 例 只 声明 了 一 种 模式 。 你 可 以 在 想 要 使 用 的 名 称 前 面 再 加 一 个 x ( 例 
如 x-sadun-services) 。 虽 说 制定 URL 模 式 标准 的 组 织 没 有 规定 iOS 程 序 所 应 使 用 的 模式 ， 但 我 们 可 以 通过 开头 的 这 个 x 来 表示 这 是 个 未 注册 的 名 称 。http://x- 
callback-url.com 网 站 正在 研讨 x-callback-url 规 学 草案 。 


有 很 多 非 正 式 的 模式 注册 网 站 ，iOS 开 发 者 可 以 把 自己 的 模式 分 享 到 这 些 网 站 中 。 我 们 可 以 找到 上 自己 想 调用 的 程序 遵循 何 种 模式 ， 也 可 以 把 自己 所 使 用 的 模式 告诉 
别人 。 这 种 网 站 会 把 各 项 服务 及 其 URL 模 式 列 出 来 ， 并 告诉 其 他 开发 者 应 该 如 何 使 用 这 些 服 
$$. http://handleopenurl.com, http://wiki.akosma.com/IPhone URL Schemes 及 http://applookup.com/Home 都 是 这 样 的 网 站 。 


11.8.2 测试 URL 


开发 者 可 以 测试 某 个 URL 服 务 是 否 可 用 。UIApplication 的 canOpenURL: 方法 如 果 返 回 YES， 就 表明 我 们 可 以 用 openURL: 来 启动 男 一 个 程序 ， 并 开启 那个 
URL: 


if ([[UIApplication sharedApplication] canOpenURL:aURL]? 
[[UIApplication sharedApplication] openURL:aURL] ; 


这 并 不 表示 URL 本 身 是 有 效 的 ， 它 只 能 闹 明 系统 里 面 已 经 有 程序 正确 地 注册 了 这 种 模式 。 


11.8.3 ”添加 处 理 程序 方法 


为 了 处 理由 其 他 程序 传 过 来 的 URL 请 求 ， 我 们 可 以 像 解 决 方案 11-8 一 样 ， 实 现 UIApplicationDelegate 协 议 中 的 application: openURL: sourceApplication: 
annotation: 方法 。 此 方法 只 能 在 应 用 程序 已 经 运行 的 时 候 触 此 。 如 果 程 序 尚 未 运行 ， 而 系统 又 接 到 了 需要 由 该 程序 来 处 理 的 URL 请 求 ， 那 么 系统 会 先 执行 与 程序 局 
动 有 关 的 那 两 个 回调 方法 (也 就 是 application: didFinishLaunchingWithOptions: 和 application: willFinishLaunchingWithOptions: ) 。 


解决 方案 11-8 提供 对 URL 模 式 的 支持 


// Called if the app is open or if didFinishLaunchingWithOptions returns YES 
- (BOOL)application: (UIApplication *)application 
OpenURL: (NSURL *)url 
sourceApplication: (NSString *)sourceApplication 
annotation: (id) annotation 


| 
NSString *logString - [NSString stringWithFormat: 
@"DID OPEN: URL[%@] App[%@] Annotation[%@] \n", 
url, sourceApplication, annotation]; 
tbvc.textView.text - 
[logString stringByAppendingString:tbvc.textView.text]; 
return YES; 
| 


// Make sure to return YES 
- (BOOL) application: (UIApplication *)application 
didFinishLaunchingWithOptions: (NSDictionary *)launchOptions 


window - [[UIWindow alloc] 
initWithFrame:[[UIScreen mainScreen] bounds] ] ; 
tbvc = [[TestBedViewController alloc] init]; 


UINavigationController *nav = [[UINavigationController alloc] 
initWithRootViewController:tbvc] ; 


window.rootViewController = nav; 
[window makeKeyAndVisible] ; 
return YES; 


我 们 应 该 确保 application: didFinishLaunchingWithOptions: 方法 能 够 照常 返回 YES。 这 样 的 话 ， 系 统 才能 把 控制 权 交 给 application: openURL: 
sourceApplication: annotation: ， 使 得 本 程序 可 以 处 理 传 入 的 URL。 


11.9 小 结 


开发 者 可 能 需要 在 应 用 程序 之 间 共 享 数 据 ， 并 且 需 要 使 用 由 系统 所 提供 的 某 些 操 作 。 本 章 讲 述 了 这 些 功能 的 实现 方式 。 读 者 学 到 了 UTI 这 个 概念 ， 还 学 到 了 在 应 用 
程序 之 间 传 递 数据 的 时 人 息 ， 应 该 如 何 用 UTI 来 表示 数据 用 途 。 大 家 看 到 了 剪贴 板 的 工作 原理 ， 也 看 到 了 怎样 用 iTunes 分 享 文件 。 此 外 ， 我 们 还 讲 了 如 何 监 控 文 件 夹 以 及 
如 何 实 现 自 定义 的 URL 模 式 。 读 者 深入 了 解 到 活动 视图 控制 器 (UIActivityViewController) 及 文档 交互 控制 器 (UlDocumentinteractionController) 的 用 法 ， 并 且 
看 到 了 如 何 令 应 用 程序 广 持 “打印 ”及 “ 预 员 ”等 操作 。 学 习 下 一 章 之 前 ， 先 回顾 下 面 几 个 知识 点 : 


开发 者 未 必 非 要 使 用 苹果 公司 内 置 的 UII， 不 过 ， 在 定义 自己 的 UTI 时 ， 应 该 遵循 蔷 果 公司 的 惯例 。 务 必 按 照 反 向 域名 格式 来 定义 UII， 并 且 在 导出 的 定义 信息 
里 面 尽量 多 提供 一 些 细节 (诸如 公开 的 URL 定 义 页 面 、 常 用 的 图 标 以 及 文件 扩展 名 等 ) 。UTI 定 义 得 越 准确 越 好 。 


` 通过 解决 方案 11-1 提 供 的 依从 关系 数组 ， 我 们 可 以 判断 出 数据 的 类 型 。 知 道 了 这 一 信息 之 后 ， 开 发 者 就 可 以 更 好 地 处 理 文 件 中 的 数据 了 ， 比 方 说 ， 我 们 可 以 判断 
出 待 处 理 的 数据 是 图 像 ， 而 不 是 文本 文件 或 视频 文件 。 


: Documents 目录 属于 用 户 ， 而 不 属于 开发 者 。 我 们 应 该 记 住 这 一 点 ， 并 把 这 个 目录 管理 好 。 


“如果 在 编写 数据 分 享 功 


EE 时 需要 实现 “一 站 式 体验 ”， 那 么 可 能 需要 寻找 比 活动 视图 控制 器 (UlActivityViewController) 更 好 的 解决 办 法 。 不 过 ， 它 依然 是 个 易 
于 使 用 且 易 于 展示 的 控制 其 中 包含 了 一 


大 批 功能 ， 使 得 我 们 可 以 把 -OS 系统 所 提供 的 服务 集成 到 自己 的 程序 里 。 


|: 由 于 多 种 原因 ， 很 多 程序 员 都 用 过 自 定义 的 URL 模 式 ， 然 而 文档 交互 控制 器 (UID-ocumentInteractionController) 提供 了 一 种 更 好 的 方案 。 这 个 控制 器 可 以 根据 用 
户 的 需要 ， 实 现 应 用 程序 之 间 的 交互 ， 开 发 者 不 妨 指 定 一 些 注 释 (annotation) 信息 ， 使 得 接收 数据 的 那个 应 用 程序 能 够 更 加 方便 地 处 理 数 据 。 


. 如 果 系 统 里 面 没 有 其 他 程序 可 以 打开 当前 文档 ， 那 就 不 要 提供 “Openin… 按钮。 本 章 给 出 了 一 种 比较 原始 的 解决 办 法 ， 它 虽然 不 够 优雅 ， 但 是 若 不 解决 该 问 
题 ， 会 令 用 户 感到 愤怒 、 温 丧 或 者 困惑 。 在 使 用 这 套 办 法 的 基础 上 ， 我 们 可 以 提供 一 个 警示 界面 ， 告 诉 用 户 没 有 别 的 程序 能 打开 此 文档 。 


612€ ” 浅 谈 Core Data 


iOS 的 Core Data 框 架 提供 了 保存 持久 化 数据 的 解决 方案 。 应 用 程序 可 以 查询 并 更 新 Core Data 的 托管 数据 存储 区 。Core Data 提 供 了 一 套 基 于 Cocoa Touch 的 对 
象 接 口 ， 使 iOS 开 发 者 可 以 用 就 悉 的 Objective-C 来 管理 关系 型 数据 库 ， 而 不 必 再 使 用 SQL 查 询 语句 。Core Data 技 术 能 够 同 表格 视图 与 集合 视图 完美 结合 起 来 。 


本 章 介 绍 Core Data。 笔 者 会 给 出 足够 的 入 门 知 识 ， 使 你 初步 了 解 这 门 技 术 ， 并 为 今后 深入 学 习 Core Data 打 下 基础 。 读 完 这 一 章 之 后 ， 大 家 就 会 明白 应 该 如 何在 
iOS 程 序 里 面 使 用 Core Data， 并 且 了 解 该 技术 。 


12.1 Core Data 人 简介 


Core Data 简 化 了 应 用 程序 创建 及 使 用 持久 化 对 象 的 方式 ， 这 种 新 方式 残 是 托管 对 象 。 在 3.x 版 本 之 前 的 SDK 中 ， 用 来 管理 数据 及 访问 SQL 的 所 有 操作 ， 都 位 于 一 
套 相当 底层 的 程序 库 里 。 那 个 程序 库 不 够 优雅 ， 而 且 也 不 易 使 用 。 从 3.x 开 始 ，Core Data 就 加 入 了 Cocoa Touch 框 架 系列 中 ， 它 为 jiOS 开 发 者 带 来 了 一 套 强 大 的 数据 
管理 机 制 。Core Data 有 着 相当 灵活 的 底层 架构 ， 而 且 提 供 了 操作 持久 化 数据 存储 区 的 工具 ， 同 时 还 可 以 生成 管理 对 象 整个 生命 期 的 解决 方案 。 


在 模型 -视图 -控制 器 (Model-View-Controller，MVC) 范式 中 ，Core Data 位 于 模型 部 分 。 之 所 以 要 这 样 设计 ， 是 因为 程序 专用 的 那 部 分 数据 应 该 定义 在 程序 
的 GUI 以 外 ， 而 且 应 该 从 GUI 外 面 操 作 ， 即 便 这 些 数据 是 用 来 驱动 应 用 程序 界面 的 ， 我 们 也 依然 应 该 这 样 想 。Core Data 能 够 同 表格 视图 与 集合 视图 很 好 地 集成 在 一 
#2, Cocoa Touch 的 NSFetchedResultsController 类 就 是 这 样 设计 并 构建 出 来 的 ， 它 能 够 与 上 面 说 的 那些 视图 类 协同 运作 。 该 类 提供 了 一 些 有 用 的 属性 及 方法 ， 使 得 
开发 者 可 以 提供 数据 源 ， 并 把 相关 的 委托 集成 进来 。 


12.2 ”实体 与 模型 


实体 位 于 Core Data 体 系 最 顶层 ， 摘 述 了 数据 库 里 面 仓储 的 对 象 。 实 体 融 好 比 饼 干 切割 器 ， 用 来 指明 每 个 数据 对 象 应 该 如 何 创建 出 来 。 创 建新 对 象 的 时 候 ， 实 体会 
详细 摘 述 出 构成 每 个 对 象 的 属性 及 关系。 每 个 实体 都 有 名 称 ， 程 序 在 运行 的 时 候 ，Core Data 会 根据 这 个 名 称 来 获取 实体 的 描述 信息 。 


开 友 者 需要 在 模型 文件 里 构建 实体 。 每 个 同 Core Data 框 以 相 链 接 的 项 目 ， 都 包含 一 个 或 多 个 模型 文件 。 这 些 .xcdatamodeld 文 件 定义 了 实体 、 实 体 的 属性 以 及 实 
体 间 的 关系 。 


12.2.1 构建 模型 文件 


要 想 创 六 Core Data 模 型 ， 我 们 需要 在 Xcode 中 新 建 数据 模型 文件 。 某 些 iOS 模 板 已 经 把 Core Data 作 为 项 目的 一 部 分 包含 进来 了 。 如 果 不 是 这 样 ， 那 么 开发 者 需 
要 在 Xcode 中 手工 创建 它 。 选 择 Xcode 的 File> New>File 菜 单项 ， 然 后 选择 jiOS、Core Data, Data Model， 并 单 击 Next 按 钮 。 输 入 新 文件 的 名 字 (本 例 使 用 的 是 
Person) ， 色 选 与 项 目 相对 应 的 目标 ， 然 后 单 击 9ave 按 钮 。Xcode 会 新 建 模 型 文件 ， 并 将 其 加 入 项 目 中 (本 例 的 模型 文件 叫 作 Person.xcdatamodeld) 。 在 File 
Navigator 中 点 击 xcdatamodeld 文 件 ， 就 会 打开 如 图 12-1 所 示 的 编辑 器 窗口 。 
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图 12-1 开发 者 可 以 在 Xcode 的 编辑 器 中 为 自己 的 Core Data 应 用 程序 定义 托管 对 象 


在 编辑 器 窗口 中 ， 我 们 可 以 点 击 左 下 角 的 Add Entity 按 钮 来 向 左 侧 列 表 里 添加 新 的 实体 (实体 基本 上 相当 于 对 象 所属 的 类 ) ， 还 可 以 点 击 右 下 角 的 Add Attribute 
按钮 来 添加 属性 (实体 的 属性 相当 于 实例 变量 ) 。 双 击 实体 名 称 或 属性 名 称 ， 即 可 为 其 改名 ， 另 外 可 以 用 Type 列表 框 来 修改 属性 的 类 型 。 


开发 者 可 以 在 编辑 器 中 间 的 区 域 里 定制 实体 的 属性 及 关系 。 关 系 是 一 种 联系 方式 ， 能 够 把 本 实体 与 数据 库 中 的 其 他 实体 关联 起 来 。 右 侧 的 inspector 面 板 提供 了 与 
当前 情境 相关 的 设 定 ， 在 图 12-1 中 ， 列 出 了 Person 实 体 emailaddress 属 性 的 详细 信息 。 


Entity 编 辑 器 提供 了 两 种 界面 风格 。 你 可 以 点 击 编辑 器 面板 右 下 和 角 的 Editor Style 按钮 ， 在 表格 视图 与 对 象 图 之 间 切 换 。 


图 12-1 中 的 详细 列表 风格 ， 会 列 出 模型 中 定义 的 每 个 实体 、 实 体 的 每 个 属性 以 及 与 其 他 实体 的 关系 。 而 对 和 象 图 风格 的 界面 则 会 以 网 格 状 来 显示 模型 中 定义 的 实 
体 ， 并 以 直观 的 方式 搓 述 实 体 间 的 关系， 使 得 开发 者 可 以 编辑 这 些 关 系 。 例 如 ， 父 杀 或 母 杀 (parent) 可 以 有 多 个 孩子 (child) 及 一 名 配偶 (spouse) 。 部 门 


(department) 可 以 包含 多 位 成 员 (member) ， 经 理 (manager) 可 以 服务 于 多 个 委员 会 (committee) 。 


12.2.2 属性 与 关系 


每 个 实体 都 可 以 包含 属性 ， 用 来 仓储 名 字 、 生 日 、 称 谓 等 信息 。 与 实体 相对 应 的 Objective-C 对 象 ， 则 会 用 性 质 (property) 来 摘 述 这 些 属性 。 


每 个 实体 也 可 以 定义 关系 ， 用 来 把 一 个 对 象 与 另 一 个 对 象 联系 起 来 。 关 系 可 以 是 单一 的 (single) ， 即 一 对 一 关系 (one-to-one relationship， 比 如 某 人 和 其 配 
偶 的 关系 、 某 人 和 其 雇主 的 关系 ) ， 也 可 以 是 多 重 的 (multiple) ， 即 一 对 多 关系 (one-to-many relationship， 比 如 某 人 与 其 孩子 之 间 的 关系 、 某 人 与 其 信用 卡 账 
户 之 间 的 关系 ) 。 此 外 ， 还 可 以 有 相互 (reciprocal) 关系 ， 即 反 向 关系 (inverse relationship， 比 如 甲 是 乙 的 孩子 ， 乙 就 是 甲 的 父亲 或 母亲 ) 。 


点 选 某 个 实体 之 后 ， 就 可 以 为 其 添加 属性 了 。 选 中 实体 后 ， 点 击 编辑 器 面板 右 下 方 的 Add Attribute 按 钮 。 (或 者 按 住 这 个 按钮 不 放 ， 然 后 从 Add Attribute, 
Add Relationship 与 Add Fetched Property 中 进行 选择 。) 每 个 属性 都 有 名 称 及 数据 类 型 ， 这 和 定义 实例 变量 时 是 相似 的 。 


关系 提供 了 指向 其 他 对 象 的 指针 。 当 编辑 器 处 于 对 象 图 风格 时 ， 开 发 者 可 以 按 住 Ctrl 键 ， 以 拖 电 鼠标 的 方式 在 实体 之 间 建 立 关 系 。 通 过 箭头 ， 我 们 可 以 看 出 项 目 中 
各 实体 之 间 的 天 系 。 


时 说 Core Data 对 关系 型 数据 库 提供 了 非常 强大 的 支持 ,但 是 在 最 简单 的 情况 下 ， 我 们 可 以 只 创建 一 个 实体 ， 并 且 不 创建 任何 关系。 大 多 数 iO0S 应 用 程序 都 不 需要 
太 过 复杂 的 实体 结构 。 对 于 表格 视图 与 集合 视图 来 说 ， 使 用 包含 section 属 性 的 平面 数据 库 束 足 够 了 。 


若 想 构建 图 12-1 中 的 模型 ， 我 们 需要 创建 Person 实 体 ， 并 添加 7 个 属性 : emailaddress、gender、givenname、middleinitial、occupation、surname 及 


section。 每 个 属性 的 类 型 都 要 设 为 String。 


12.2.3 ”构建 NSManagedObject 的 子 类 


创建 好 实体 的 定义 之 后 ， 把 修改 过 的 数据 保存 到 数据 模型 文件 中 。 在 屏幕 左 侧 的 边栏 里 选 定 某 个 实体 ， 然 后 点 击 Xcode 的 Editor>Create NSManagedObject 


Subclass 菜 单项 。 选 中 数据 模型 以 及 想 要 托管 的 实体 (可 以 选 定 多 个 实体 ) 。 把 待 生 成 的 文件 保存 到 项 目的 文件 夹 中 ， 同 时 还 要 指定 这 个 类 将 要 添加 到 项 目的 哪 一 个 
组 里 ， 然 后 点 击 Create 按 钮 。Xcode 会 根据 开 友 者 所 提供 的 实体 摘 述 信息 来 生成 类 文件 。 下 面 残 是 由 Xcode 上 自动 生成 的 Person 类 : 


@interface Person : NSManagedObject 


@property (nonatomic, strong) NSString *section; 


@property (nonatomic, strong) NSString *emailaddress; 


@property (nonatomic, strong) NSString *gender; 


@property (nonatomic, strong) NSString *middleinitial; 


@property (nonatomic, strong 


) 
) 
) 

eproperty (nonatomic, strong) NSString *givenname; 
) 
) NSString *occupation; 
) 


Gproperty (nonatomic, strong) NSString *surname; 


@end 
@implementation Person 


@dynamic section; 
@dynamic emailaddress; 
@dynamic gender; 
Gdynamic givenname; 
@dynamic middleinitial; 
@dynamic occupation; 
Gdynamic surname; 


@end 


每 个 属性 (attribute) 都 对 应 于 一 个 字符 串 型 的 特性 (property) 。 如 果 你 使 用 了 其 他 的 属性 类 型 ， 那 么 生成 的 特性 类 型 也 会 随 之 改变 (比如 ， 可 能 会 生成 
NSDate、NSNumber 或 NSData 型 的 特性 ) 。 假 如 添加 了 一 对 多 天 系 ， 那 么 融会 生成 NS9Set 型 的 特性 。@dynamic 指 令 可 以 在 程序 运行 的 时 候 创建 与 特性 相 天 的 访问 
器 。 


123 创建 下文 


{Core Data 中 ， 实 体 提 供 了 描述 信息 。 而 托管 对 象 则 是 根据 实体 规范 创建 出 来 的 类 实例 。 这 些 实 例 都 创建 自 NSManagedObject 类 ， 表 示 数 据 库 中 的 相关 记录 。 


Core Data 对 象 位 于 托管 对 象 上 下 文 之 中 。 这 些 上 下 文 都 是 NSManagedObject-Context 的 实例 ， 每 个 上 下 文 都 表示 应 用 程序 中 的 某 一 块 对 象 空间 。 本 章 只 采用 
一 个 NSManagedObjectContext， 如 果 你 的 程序 比较 复杂 ， 那 么 可 能 会 用 到 多 个 上 下 文 ， 这 通常 是 为 了 使 多 个 线程 能 够 同时 访问 Core Data 而 设计 的 。 


在 单一 上 下 文 的 范例 中 ， 开 发 者 启动 程序 时 就 会 创建 NSManagedObjectContext， 并 用 这 个 上 下 文 来 执行 数据 获取 请 求 ， 以 便 从 数据 库 中 获取 数据 。 使 用 上 下 文 
的 时 候 ， 首 先 要 把 应 用 程序 仓 (application bundle) 中 创建 的 模型 加 载 进 来 。 这 里 不 需要 指定 名 称 : 


// Init the model 
NSManagedObjectModel *managedObjectModel - 
[NSManagedObjectModel mergedModelFromBundles:nil]; 


接 下 来 ， 创 建 存储 区 协调 器 并 将 其 和 应 用 程序 沙 盒 内 的 某 个 文件 (也 就 是 某 个 数据 存储 区 ) 相连 。 在 程序 中 ， 协 调 器 负责 处 理 托 管 对 象 模型 与 本 地 文件 之 间 的 关 
系 。 开 发 者 提供 的 URL 应 该 指明 保存 数据 所 用 的 文件 。 下 面 这 段 代 码 使 用 NSSQLiteStoreType 类 型 的 数据 库 ， 也 就 是 说 ， 它 会 创建 一 份 使 用 标准 SQLite 二 进 制 格式 的 
文件 : 


// Create the store coordinator 
NSPersistentStoreCoordinator *persistentStoreCoordinator - 
[(NSPersistentStoreCoordinator alloc] 
initWithManagedObjectModel:managedObjectModel]; 


// Connect to the data store (on disk) 

NSURL *url = [NSURL fileURLWithPath:dataPath] ; 

if (![persistentStoreCoordinator 
addPersistentStoreWithType: NSSQLiteStoreType 
configuration:nil URL:url options:nil error:&error]) 


NSLog(@"Error creating persistent store coordinator: %@", 
error.localizedFailureReason); 
return; 


最 后 ,创建 上 下 文 ， 并 把 它 的 persistentStoreCoordinator 属 性 设置 成 刚才 创建 的 那个 协调 器 : 


// Create a context and assign to the context property 
context - [[NSManagedObjectContext alloc] init]; 
 context.persistentStoreCoordinator = persistentStoreCoordinator; 


12.4 添加 数据 


开发 者 可 以 用 NSEntityDescription 类 向 上 下 文中 插入 新 对 象 。 这 样 的 话 ， 我 们 就 可 以 用 新 的 数据 记录 来 填充 数据 存储 文件 了 。 插 入 对 象 的 时 候 ， 要 提供 实体 名 
称 ， 以 及 当前 正在 操作 的 上 下 文 : 


// Create new object 
- (NSManagedObject *)newObject 


| 


NSManagedObject *object - [NSEntityDescription 
insertNewObjectForEntityForName: entityName 
inManagedObjectContext: context] ; 


return object; 


上 述 方法 会 返回 新 建 的 NSManagedObject， 以 供 开发 者 操作 。 获 得 这 个 新 的 托管 对 象 之 后 ， 我 们 就 可 以 根据 自己 的 需要 来 修改 它 了 ， 修 改 完 之 后 ， 应 该 将 其 存 
入 上 下 文 : 


// Save 
- (BOOL) save 


NSError _autoreleasing *error; 
BOOL success; 
if (!(success = [ context save:&error])) 


NSLog(G"Error saving context: %@", error.localizedFailureReason) ; 
return success; 


常见 的 用 法 是 这 样 的 : 首先 创建 一 个 或 多 个 新 对 象 ， 然 后 设置 其 属性 ， 最 后 保存 。 我 们 可 以 用 下 面 这 段 代 码 来 调用 上 述 方法 ， 以 便 在 数据 库 中 插入 新 的 Person 实 
体 : 


Person *person = (Person *)[dataHelper newObject]; 

person.givenname - G"Chris"; 

person.surname = G"Zahn"; 

person.section - [[person.surname substringFromIndex:0] substringToIndex:1]; 
person.occupation = @"Editor"; 

[dataHelper save] 


请 注意 ，section 属 性 是 根据 surname 属 性 计算 出 来 的 。 在 比较 简单 的 iOS 程 序 里 ,我 们 基本 上 都 会 添加 section 这 样 的 属性 ， 以 便 使 Core Data 能 够 依照 数据 之 间 
的 共性 对 其 分 组 。 属 性 的 名 称 并 不 重要 ， 到 时 候 只 是 把 它 作 为 参数 传 给 相关 方法 。 笔 者 之 所 以 选 了 section 这 个 名 字 ， 是 因为 它 好 认 而 且 好 记 。 有 高 端 需 求 的 开发 者 可 
能 会 编写 一 个 方法 ， 用 来 实现 自己 的 分 组 标准 ， 而 不 是 像 本 例 这 样 直接 使 用 硬 代码 。 


上 面 这 段 代 码 会 按照 姓氏 的 首 字 母 来 分 组 。 如 果 想 根据 其 他 属性 分 组 ， 可 以 逐个 修改 每 个 对 象 的 section， 依 照 那 个 属性 来 决定 section 的 值 ， 也 可 以 在 执行 数据 获 
取 请 求 时 不 传 入 section， 而 是 传 入 另外 一 个 属性 。 通 过 这 些 灵活 的 做 法 ,我们 可 以 把 按 姓 氏 首 字母 分 组 改 成 按 职业 分 组 。 本 章 稍 后 会 讨论 如 何 获 取 及 查询 Core Data 
存储 区 中 的 数据 。 


不 要 把 iOS 的 section (也 束 是 表格 视图 和 和 集合 视图 所 用 的 区 段 ) 和 sorting 相 混淆 ， 后 者 是 Core Data 中 的 另外 一 个 概念 。section 是 把 一 批 对 象 分 成 若干 组 ， 而 
sorting 则 决定 了 每 一 组 里 的 对 象 之 间 应 该 怎样 排序 。 


查看 数据 文件 


如 果 在 模拟 器 里 运行 上 述 代 码 ， 很 容易 就 能 看 到 由 Core Data 所 创建 的 SQLite 文 件 。 打 开 模 拟 器 文件 夹 (~/Library/Application Support/iPhone 
Simulator/Firmware/Applications， 其 中 Firmware 是 指 当 前 的 固件 版 本 ， 比 如 7.0) ， 然 后 打开 与 本 应 用 程序 相对 应 的 子 文件 夹 。 


Documents 目 录 中 的 SQLite 文 件 (具体 位 置 取决 于 创建 持久 化 存储 区 时 所 用 的 URL) 里 面包 含 了 一 份 数据 库 ， 用 以 代表 我 们 刚才 创建 的 那些 数据 。 执 行 sqlite3 这 
个 命令 行 工具 ， 然 后 用 .dump 操 作 来 查看 其 内 容 : 


Q 


% sqlite3 Person.sqlite 

SOLite version 3.7.13 2012-07-17 17:46:21 
Enter ".help" for instructions 

Enter SQL statements terminated with a ";" 
sqlite» .dump 

PRAGMA foreign keys=OFF; 


CREATE TABLE ZPERSON ( Z PK INTEGER PRIMARY KEY, Z ENT INTEGER, Z OPT INTEGER, 
ZEMAILADDRESS VARCHAR, ZGENDER VARCHAR, ZGIVENNAME VARCHAR, ZMIDDLEINITIAL VARCHAR, 
ZOCCUPATION VARCHAR, ZSECTION VARCHAR, ZSURNAME VARCHAR ) ; 


INSERT INTO "ZPERSON" VALUES (1,1,1, 'ChristopherLRobinson@foomail.com', 'male', 'Christop 
her','L','Home care aide','C', 'Robinson') ; 

INSERT INTO "ZPERSON" VALUES (2,1,1, 'NicholasJGrant@spambob.com','male','Nicholas','J', 
'Steadicam operator','N','Grant'); 

INSERT INTO "ZPERSON" VALUES(3,1,1,'JosephJTreeceGspambob. 
com','male','Joseph','J','Shoe machine operator','J', 'Treece') ; 

INSERT INTO "ZPERSON" VALUES (4,1,1, 'HelenEShaffer@dodgit. 
com','female','Helen','E','Coin vending and amusement machine servicer 
repairer','H','Shaffer'); 

CREATE TABLE Z PRIMARYKEY (Z ENT INTEGER PRIMARY KEY, Z NAME VARCHAR, Z SUPER INTEGER, 
Z MAX INTEGER) ; 

INSERT INTO "Z PRIMARYKEY" VALUES(1,'Person',0,3000); 


CREATE TABLE 4 METADATA (Z VERSION INTEGER PRIMARY KEY, 2 UUID VARCHAR(255), Z PLIST 
BLOB) ; 


INSERT INTO "Z METADATA" VALUES (1, '85E928DB-1464-4C3B-BCEA- 
9277B8817A04',X'62706C6973743030D601020304050607090A0DOE0F5F101E4E5353746F72654D6F646 
56C56657273696F6E4964656E746966696572735F101D4E5350657273697374656E63654672616D65776F 
726B56657273696F6E5F10194E5353746F72654D6F64656C56657273696F6E4861736865735B4E5353746 
F7265547970655F10125F4E534175746F56616375756D4C6576656C5F10204E5353746F72654D6F64656C 
56657273696F6E48617368657356657273696F6EA1085011019AD10B0C56506572736F6E4F1020D261E38 
54795D61A5D69048846ECC3DCFEACA4861D9FCD1540A071C875FE89EA95653514C69746551321003081536 
56727E93B6B8B9BCBFC6E9F0F200000000000001010000000000000010000000000000000000000000000 
000F4'); 

COMMIT; 

sqlite> .quit 

* 


上 面 有 很 多 SQL 表格 定义 语句 ， 它 们 用 来 保存 每 个 对 象 的 信息 ， 另 外 还 有 一 些 insert 命 令 ， 用 来 存放 程序 代码 所 构建 的 实例 。 昌 说 我 们 不 应 该 直接 用 sqlite3 来 操作 
Core Data 存储 区 ， 但 它 能 使 我 们 看 到 Core Data 在 底层 所 执行 的 操作 。 


12.5 ”查询 数据 库 


我 们 可 以 通过 执行 NSFetchRequest (获取 请 求 ) 来 从 数据 库 中 获取 对 象 。NSFetch-Redquest 描 述 了 选取 对 象 时 所 依从 的 标准 。 开 发 者 把 它 传 给 Core Data， 并 用 
它 来 初始 化 NSFetchedResultsController， 以 便 存 放 获 取 结 果 ， 执 行 完 NSFetchRequest 之 后 ， 系 统 将 把 符合 标准 的 对 象 放 到 NSFetchedResultsController 里 面 的 某 
个 数组 中 。 本 例 的 fetchltemsMatching 方 法 会 把 获取 到 的 结果 存放 在 名 为 fetchedResults-Controller 的 实例 变量 中 ， 该 变量 与 CoreDataHelper 类 中 的 属性 相关 联 : 


- (void) fetchItemsMatching: (NSString *)searchString 
forAttribute: (NSString *)attribute 
sortingBy: (NSString *)sortAttribute 


// Build an entity description 


NSEntityDescription *entity - [NSEntityDescription 
entityForName: entityName inManagedObjectContext: context]; 


// Init a fetch request 
NSFetchRequest *fetchRequest = [{NSFetchRequest alloc] init]; 


fetchRequest.entity - entity; 
[fetchRequest setFetchBatchSize:0]; 


// Apply an ascending sort for the items 

NSString *sortKey = sortAttribute ? : defaultSortAttribute; 

NSSortDescriptor *sortDescriptor - [[NSSortDescriptor alloc] 
initWithKey:sortKey ascending:YES selector:nil]; 

NSArray *descriptors = G[sortDescriptor]; 

fetchRequest.sortDescriptors - descriptors; 


// Optional setup predicate 
if (searchString && attribute) fetchRequest.predicate - 
[NSPredicate predicateWithFormat:@"%K contains[cd] 50", 
attribute, searchString]; 


// Perform the fetch 

NSError _autoreleasing *error; 

 fetchedResultsController - [[NSFetchedResultsController alloc] 
initWithFetchRequest:fetchRequest managedObjectContext: context 
sectionNameKeyPath:@"section" cacheName:nil]; 

if (![ fetchedResultsController performFetch:&error]) 
NSLog(@"Error fetching data: $8", error.localizedFailureReason); 


12.5.1 配置 NSFetchRequest 
NSFetchRequest 描 述 了 开发 者 想 要 如 何 搜索 数据 。 首 先 要 根据 给 定 的 实体 名 称 取得 该 实体 的 描 述 信息 。 对 于 Person 实 体 来 况 ， 这 个 实体 名 称 就 是 @"Person"。 
描述 信息 指明 了 待 搜索 的 数据 类 型 。 


新 建 NSFetchRequest 之 后 ， 我 们 应 该 把 刚才 获取 到 的 实体 描述 信息 (NSEntity-Description) 设置 给 它 ， 并 设置 fetchBatchSize。 如 果 fetchBatchSize 的 值 是 
0， 那 么 表示 一 次 获取 完 ， 不 分 批 处理 。 知 想 分 批 次 获取 ， 则 将 fetchBatchsize 设 为 正 值 。 


每 个 NSFetchRequest 必 须 包含 至 少 一 个 排序 描述 符 。 上 一 节 里 的 那个 方法 会 依照 sortKey， 将 获取 到 的 对 象 按 升序 (ascending: YES) 排列 。 与 实体 名 称 一 
样 ，sortKey 也 是 个 字符 串 (比如 ， 那 个 例子 所 用 的 字符 串 是 @ "surname") 。 开 上 友 者 需要 把 包含 摘 述 符 的 数组 设置 给 NSFetchRequest 的 sortDescriptors 属 性 。 


NSFetchRequest 可 以 用 谓词 来 过 滤 搜 索 结果 ， 使 其 中 只 包含 符合 某 些 规则 的 内 容 。 如 果 调 用 者 提供 了 searchstring 及 attribute 参 数 ， 那 么 fetchltemsMatching 
方法 就 会 创建 出 attribute contains[cd]jsearchstring 形 式 的 谓词 。 


这 种 谓词 在 匹配 文本 的 时 候 ， 不 区 分 大 小 写 。contains 后 面 的 [cd] 表 示 匹 配 的 时 候 既 不 区 分 大 小 写 ， 也 不 区 分 附加 符号 (diacritic) 。 附 加 符号 是 与 字母 相伴 的 小 
标记 ， 比 方 说 表示 变 音 的 两 个 点 (umlaut,“) ， 或 是 西班牙 语 字 母 nM 上 方 的 浪 弘 线 (tilde，~) 。 


在 谓词 中 ，%@ 格 式 表示 字符 串 值 ， 比 方 说 ， 我 们 可 以 用 它 来 表示 searchString 参 数 中 的 字符 串 。 而 %K 则 表示 实体 中 某 个 属性 的 值 。 假 如 在 本 该 使 用 %K 的 地 方 使 
用 了 %@,， 那 么 surname'contains[cd]'u' 这 个 谓词 就 总 是 true， 因 为 surname 的 第 二 个 字母 是 u。%K 的 意思 是 匹配 属性 的 值 ， 而 不 是 匹配 这 个 属性 的 名 字 。 


如 果 要 执行 更 为 复杂 的 查询 ， 那 么 可 以 配置 复合 谓词 (compound predicate) 。 复 合 谓词 能 够 以 AND、OR 及 NOT 等 标准 的 逻辑 操作 符 来 组 合 简单 的 谓词 。 
NSCompoundPredicate 类 会 从 单个 谓词 中 构建 出 复合 谓词 。 此 外 ， 也 可 以 不 使 用 NSCompoundPredicate 类 ， 而 是 直接 把 AND、OR 及 NOT 等 记 法 认 入 简单 的 
NSPredicate 文 本 里 。 


Qi 谓词 是 一 套 能 够 过 滤 数 据 并 搜索 数据 的 强大 机 制 。 革 果 公 司 的 《Predicate Programming Guide» 详细 地 解释 了 如 何 创建 及 使 用 谓词 。 请 参 
阅 : https://developet.apple.com/libraty/ios/DOCUMENTATION/Cocoa/Conceptual/Predicates /predicates.html o 


12.5.2 ”执行 数据 获取 操作 


我 们 要 针对 每 一 种 查询 操作 新 建 与 之 对 应 的 NSFetchedResultsController， 然 后 用 NSFetchRequest、NSManagedObjectContext 及 sectionNameKeyPath 来 
初始 化 它 。sectionNameKeyPath 参 数 的 值 可 以 设 成 @"section"， 只 要 对 象 里 定义 了 名 为 section 的 属性 就 行 。 通 常 来 说 ， 上 面 这 些 需求 都 不 难 办 到 |。 


控制 器 的 初始 化 方法 里 面 ， 有 个 名 为 name 的 参数 ， 用 来 表示 缓 企 。 获 取 数 据 的 时 候 ， 系 统 要 把 数据 安排 到 各 个 区 段 的 不 同位 置 上 面 ， 而 缓存 则 可 以 减少 这 一 过 程 
的 开销 。 如 果 数 据 没有 变化 ， 那 么 下 次 获取 的 时 候 ， 直 接 从 缓存 里 取 束 可 以 了 ， 这 样 能 够 降低 程序 运行 过 程 中 的 数据 获取 开销 。 缓 存 名 称 可 以 任意 选取 。 如 果 不 想 使 
用 缓存 功能 ， 那 么 将 其 设 为 nil， 如 果 想 使 用 ， 那 就 提供 一 个 字符 串 。 为 了 避免 与 修改 NSFetchRequest 有 关 的 一 些 错 误 ，fetchltemsMatching 方 法 把 这 个 参数 设 成 了 


nil, 


最 后 ,调用 performFetch 方 法 ,执行 数 据 获 取 操 作 。 如 果 成 功 ， 那 么 此 方法 就 返回 true。 若 是 失败 ， 则 会 修改 由 调用 者 以 引用 形式 传 入 的 error 参 数 ， 使 其 获知 该 
操作 为 何 出 错 。 


获取 操作 是 同步 执行 的 。 当 该 方法 返回 之 后 ， 开 发 者 就 可 以 直接 通过 NSFetched-ResultsController 的 fetchedObjects 属 性 获取 到 对 象 数 组 了 。 下 面 这 段 代 码 演示 
了 如 何 用 fetchltemsMatching 来 获取 数据 。 它 会 根据 文本 框 中 的 字符 串 ， 把 姓氏 之 中 含有 该 字符 串 的 Person 对 象 都 找 出 来 ， 并 将 其 列 在 文本 视图 里 面 。 


- (void)list 


| 


if (!textField.text.length) return; 


[dataHelper fetchItemsMatching:textField.text 
forAttribute:G"surname" sortingBy:G"surname"]; 
NSMutableString *string - [NSMutableString string]; 
for (Person *person in dataHelper.fetchedResultsController.fetchedObjects) 


f 


\ 
NSString *entry = [NSString stringWithFormat: @"%@, $09 $0: %@\n", 
person.surname, person.givenname, 
person.middleinitial, person.occupation]; 
[string appendString:entry]; 


| 


textView.text = string; 


12.6 BIRIK 


从 平面 数据 库 中 移 除 对 象 是 相当 简单 的 。 只 需 令 上 下 文 把 对 象 删 掉 ， 然 后 保存 上 下 文 即 可 。 下 面 两 个 方法 分 别 用 来 删除 数据 库 中 的 单个 对 象 及 全 部 对 象 : 


// Delete one object 
- (BOOL)deleteObject: (NSManagedObject *)object 


{ 
[self fetchData]; 
if (! fetchedResultsController.fetchedObjects.count) return NO; 
[ context deleteObject:object] ; 
return [self save]; 
| 


// Delete all objects 
(BOOL)clearData 


| 
[self fetchData]; 
if (! fetchedResultsController.fetchedObjects.count) return YES; 
for (NSManagedObject *entry in 
 fetchedResultsController.fetchedObjects) 
[ context deleteObject:entry]; 
return [self save]; 


} 


如 果 对 象 乙 间 还 有 关系 ， 那 么 移 除 起 来 可 能 会 稍微 复杂 一 点 。Core Datat ESI BU, DIRAE, EDAR, MAAR. GBALA 
的 数据 模型 ， 删 除 起 来 比较 复杂 。 在 某 些 数据 模型 中 ， 开 友 者 必须 先 把 即将 失效 的 那些 引用 移 走 ， 然 后 才能 把 对 象 从 持久 化 存储 区 里 正确 地 删 探 。 各 是 不 清理 那些 引 
用 ， 则 把 对 象 删除 之 后 ， 其 他 一 些 对 象 会 指向 已 删除 的 数据 ， 从 而 产生 无 法 预料 的 错误 。 


为 了 避免 这 一 问题 ， 我 们 可 以 在 Data Model Inspector 界 面 中 设置 删除 规则 。 删 除 规则 用 来 决定 在 相关 的 对 象 即将 移 除 时 ， 程 序 应 该 对 这 个 操作 做 出 何 种 反应 。 
如 果 将 规则 设 为 Deny， 那 么 只 要 还 有 其 他 对 象 与 本 对 象 相连 ， 开 友 者 束 不 能 删除 该 对 象 。 如 果 把 规则 设 为 Nullify， 那 么 在 删除 本 对 象 之 前 ， 系 统 会 先 把 反 向 的 关系 清 
空 。Cascade 规 则 会 把 本 对 象 以 及 该 对 象 通过 这 条 天 系 所 指向 的 目标 对 象 全 部 删 掉 。 比 方 说 ,通过 Cascade 规 则 ， 我 们 可 以 把 整个 部 门 连同 其 中 的 所 有 成 员 一 并 删除 。 
No Action 规 则 会 确保 关系 所 指向 的 目标 对 象 不 受 影响 ， 即 便 那些 对 象 还 有 指向 本 对 象 的 反 向 关系 ， 开 友 者 也 依然 能 够 把 本 对 象 删 掉 。 


如 果 Xcode 发 现 了 非 相 互 关 系 (nonreciprocal relationship， 单 向 关系 ) ， 就 会 给 出 警告 。 我 们 应 该 避免 不 平衡 的 单 向 关系 ,以便 简 化 编码 工作 ， 同 时 也 能 更 好 
地 维护 内 部 一 致 性 。 若 是 无 法 避免 单 向 关系 ， 则 应 在 编写 删除 方法 的 时 候 把 它们 考虑 进来 。 


12.7 解决 方案 : 用 Core Data 来 充当 表格 的 数据 源 


Core Data 与 ijOS 的 表格 视图 结合 得 相当 紧密 。NSFetchedResultsController 类 包含 了 一 些 特性 ， 可 以 简化 Core Data 对 象 与 表格 数据 源 的 集成 过 程 。 大 家 在 下 面 
几 小 节 里 会 看 到 : NSFetchedResultsController 类 中 的 许多 属性 和 方法 ， 从 一 开始 就 是 为 支持 表格 而 设计 的 。 


12.7.1 访问 索引 路径 


NSFetchedResultsController 类 提供 了 对 象 与 索引 路 径 之 间 的 双向 查询 。 开 发 者 可 以 调用 objectAtindexPath: 从 对 象 数组 中 根据 索引 路 径 来 获取 对 象 ， 也 可 以 
调用 indexPathForObject: 根据 对 象 来 查询 索引 路 径 。 这 两 个 方法 既 适 用 于 分 区 的 表格 (sectioned table) ， 也 适用 于 不 分 区 的 普通 表格 (flat table) 一 一 只 用 一 
个 区 段 来 显示 所 有 数据 的 表格 。 


12.7.2 sectionNameKeyPath 属 性 


sectionNameKeyPath 属 性 可 以 把 托管 对 象 的 属性 与 区 段 的 名 称 相 关联 。 该 属性 用 来 决定 每 个 托管 对 象 应 该 属于 哪个 区 段 。 开 发 者 在 任何 时 间 都 可 以 直接 设置 此 
属性 ， 另 外 也 可 以 在 初始 化 NSFetchedResultsController 的 时 候 配 置 它 。 


解决 方案 12-1 采 用 名 为 section 的 属性 来 分 区 ， 不 过 开发 者 也 可 以 把 section NameKeyPath 设 置 成 其 他 属性 的 名 称 。 本 例会 把 每 个 对 象 的 section 属 性 设置 成 
surname 的 首 个 字符 。 如 果 要 使 用 不 分 区 的 普通 表格 ， 那 么 把 sectionNameKeyPath 设 为 nil。 


12.7.3 ”获取 每 个 区 段 内 的 对 象 


通过 控制 器 的 sections 属 性 ， 我 们 可 以 获取 与 每 个 区 段 相 对 应 的 小 组 。 该 属性 返回 一 系列 区 段 ， 每 个 区 段 里 面 都 保存 了 若干 托管 对 象 ， DXESTUESXJARBUsection/ss 
性 都 包含 同一 个 字母 。 


由 sections 属 性 所 返回 的 每 个 区 段 ， 都 实现 了 NSFetchedResultsSectionInfo 协 议 。 此 协议 可 以 提供 该 区 段 的 objects (对 象 ) . numberOfObjects (对 象 个 
数 ) 、name (名 称 ) 及 indexTitle。 所 谓 indexTitle， 指 的 是 在 表格 右 侧 的 快速 索引 列表 里 面 ， 与 该 区 段 相 对 应 的 那个 标题 。 


12.7.4 ”sectionIndexTitles 属 性 


NSFetchedResultsController 的 sectionindexTitles 属 性 ， 会 根据 获取 到 的 数据 所 在 的 区 段 ， 生 成 一 份 包含 各 区 段 标题 的 列表 。 对 于 解决 方案 12-1 来 说 ， 这 份 数组 
里 面 的 每 个 标题 都 是 一 个 字母 。 默 认 情 况 下 ， 系 统 会 根据 现 有 各 区 段 的 名 称 来 生成 这 份 列表 。 


还 有 两 个 实例 方法 ， 分 别 是 sectionlndexTitleForSectionName: 和 section-ForSectionlndexTitle: atlndex: ， 开 发 者 可 以 通过 它们 来 查询 区 段 标题 。 第 一 个 
方法 会 根据 区 段 的 名 称 返 回 区 段 的 标题 ， 第 二 个 方法 会 根据 区 段 的 标题 来 查询 其 编号 。 如 果 你 想 使 用 的 区 段 标题 与 系统 根据 sectionNameKeyPath 所 拟定 的 标题 不 一 
样 ， 那 么 可 以 覆 写 这 些 方 法 。 


12.7.5 Core Data 与 表格 之 间 的 紧密 结合 


从 上 面 讲 到 的 属性 及 方法 ， 我 们 可 以 看 出 : NSFetchedResultsController 实 例 非 常 适合 与 表格 相 搭配 。 解 决 方案 12-1 列 出 了 表格 的 所 有 标准 方法 ， 这 些 方法 都 是 
针对 Core Data 而 编写 的 。 大 家 可 以 友 现 ， 创 建 及 管理 区 段 所 用 的 每 个 方法 都 很 精练 。 由 于 我 们 借助 了 系统 内 置 的 Core Data 特 性 ， 所 以 每 个 方法 只 需 一 两 行 代码 就 能 
Bt, Core Data 会 直接 处 理 区 段 的 创建 及 访问 事宜 。fetchltemsMatching 方 法 在 初始 化 NSFetchedResultsController 的 时 候 ， 只 需 向 它 提供 划分 区 段 所 参照 的 属性 
就 可 以 了 。Core Data 会 完成 其 余 的 工作 。 
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图 12-2 ”解决 方案 12-1 用 极 少 量 的 代码 创建 出 了 功能 完备 的 表格 。Core Data 会 为 表格 的 所 有 特性 提供 支持 ， 包 括 单元 格 的 内 容 、 每 个 区 段 的 头 部 以 及 索引 


图 12-2 列 出 了 由 解决 方案 12-1 所 构建 的 界面 。 这 是 个 功能 完备 的 表格 ， 每 个 区 段 都 设置 了 头 部 ， 而 且 表 格 右 侧 还 有 浮动 的 索引 。 
Gis 如 果 运 行 完 本 章 的 某 条 解决 方案 之 后 又 要 运行 本 章 的 另外 一 个 解决 方案 ， 需 要 先 重 置 模 拟 器 ， 或 是 把 Hello Word 程 序 从 设备 中 删 挤 ， 因 为 本 章 所 有 的 解 
决 方案 都 使 用 同一 份 数 据 库 文 件 (Petson.sqlite) ， 该 文件 会 留 在 Documents 文 件 夹 中 。 


解决 方案 12-1 用 Core Data 构 建 分 区 的 表格 


&pragma mark Data Source 

// Number of sections 

- (NSInteger)numberOfSectionsInTableView: 
(UITableView *)tableView 


return dataHelper.fetchedResultsController.sections.count; 


} 


// Rows per section 
- (NSInteger)tableView: (UITableView *)tableView 
numberOfRowsInSection: (NSInteger) section 


id «NSFetchedResultsSectionInfo» sectionInfo = 
dataHelper.fetchedResultsController.sections [section]; 
return sectionInfo.numberOfObjects; 


// Return the title for a given section 
- (NSString *)tableView: (UITableView *)aTableView 
titleForHeaderInSection: (NSInteger)section 


NSArray *titles - [dataHelper.fetchedResultsController 
sectionIndexTitles]; 

if (titles.count «- section) 
return @"Error"; 

return titles [section]; 


// Section index titles 
- (NSArray *)sectionIndexTitlesForTableView: 
(UITableView *)aTableView 


return [dataHelper.fetchedResultsController 
sectionIndexTitles]; 


// Populate a cell for the index path 
- (UITableViewCell *)tableView: (UITableView *)tableView 
cellForRowAtIndexPath: (NSIndexPath *)indexPath 


UITableViewCell *cell - 
[tableView dequeueReusableCellWithIdentifier: 
@"cell" forIndexPath:indexPath]; 
Person *person = 
(Person *) [dataHelper.fetchedResultsController 
objectAtIndexPath:indexPath]; 
cell.textLabel.text = person.fullname; 


return cell; 


#pragma mark Delegate 
- (void)tableView: (UITableView *)tableView 
didSelectRowAtIndexPath: (NSIndexPath *)indexPath 


// When a row is selected, update title accordingly 


Person *person = 
(Person *)[dataHelper.fetchedResultsController 
objectAtIndexPath:indexPath]; 
self.title - person.fullname; 


获取 解决 方案 代码 


访问 https://github.com/erica/iOS-7-Cookbook 网 页 ， 并 打开 “C12Core Data” 文 件 夹 ， 即 可 找到 与 本 章 中 的 解决 方案 相对 应 的 完整 范例 项 目 。 


12.8 解决 方案 : 用 Core Data 实 现 表格 的 搜索 功能 


Core Data 的 存储 区 能 够 同 NSPredicate 高 效 地 结合 起 来 。 在 创建 NSFetchRequest 的 时 候 ， 可 以 通过 谓词 实现 过 滤 ， 使 得 系统 只 把 符合 谓词 规则 的 对 象 选 出 来 。 
向 NSFetchRequest 中 添加 谓词 ， 即 可 限定 获取 到 的 结果 ， 使 其 中 只 包含 与 谓词 相 匹配 的 对 象 。 解 决 方案 12-2 利 用 本 章 早 前 提 到 过 的 谓词 ， 给 表格 视图 添加 了 搜索 功 
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用 户 可 以 在 表格 中 输入 字符 串 ， 把 姓氏 中 包含 该 字符 串 的 人 找 出 来 。 表 格 顶部 是 搜索 栏 ， 如 果 其 中 的 文本 有 变化 ， 那 么 它 的 委托 融会 收 到 searchBar: 
textDidChange: 回调 。 而 这 个 回调 方法 又 会 以 用 尸 所 输 的 字符 串 为 标准 ， 重 新 获取 数据 。 


只 需要 对 解决 方案 12-1 做 下 列 几 处 修改 ， 就 可 以 使 表格 支持 搜索 功能 
: 在 loadView 方 法 中 添加 UISearchDisplayController， 并 且 令 viewDidAppeat: 方法 把 搜索 栏 滚动 到 可 视 范围 之 外 。 


: 修改 sectionIndexTitlesForTableView: 方法 ， 把 表示 搜索 功能 的 图 标 也 添加 到 索引 里 面 ， 同 时 修改 tableView: sectionForSectionIndexTitle: atIndex: 方法 ， 使 得 表 


格 可 以 把 seatrchControlletf 深 动 到 可 视 范围 之 内 。 
` 只 要 搜索 栏 的 内 容 有 变化 ， 它 的 委托 方法 就 会 获取 新 的 结果 。 这 个 方法 会 提交 新 的 Core Data 请 求 ， 以 便 重新 获取 数据 ， 并 用 新 的 数据 填充 表格 视图 。 


经 过 这 些 修改 之 后 ,我们 束 可 以 创建 出 带 有 搜索 框 的 表格 了 ， 这 种 表格 可 以 响应 用 户 所 输入 的 查询 内 容 。 从 解决 方案 12-1 及 解决 方案 12-2 我 们 可 以 看 出 ， 只 需 编 
写 极 少 的 代码 ， 束 可 以 把 表格 视图 与 Core Data 集 成 起 来 。 


解决 方案 12-2 ”使 用 谓词 过 滤 获 取 到 的 数据 


// Section index titles plus search 
- (NSArray *)sectionIndexTitlesForTableView: 
(UITableView *)aTableView 


if (aTableView -- searchController.searchResultsTableView) 
return nil; 

return [[NSArray arrayWithObject:UITableViewIndexSearch] 
arrayByAddingObjectsFromArray: 


[dataHelper.fetchedResultsController sectionIndexTitles]]; 


// Allow scrolling to search bar 

- (NSInteger)tableView: (UITableView *)tableView 
sectionForSectionIndexTitle: (NSString *)title 
atIndex: (NSInteger)index 


if (title -- UITableViewIndexSearch) 

{ 
[self.tableView scrollRectToVisible: 

searchController.searchBar.frame animated:NO]; 

Perurmp sl: 

} 

return [dataHelper.fetchedResultsController.sectionIndexTitles 
indexOfObject:title] ; 


// Return a cell specific to the table being shown 
- (UITableViewCell *)tableView: (UITableView *)aTableView 
cellForRowAtIndexPath: (NSIndexPath *)indexPath 


[aTableView registerClass: [UITableViewCell class] 
forCellReuseIdentifier:G"cell"]; 

UITableViewCell *cell - 
[aTableView dequeueReusableCellWithIdentifier:@"cell" 

forIndexPath:indexPath]; 

Person *person - [dataHelper.fetchedResultsController 
objectAtIndexPath:indexPath]; 

cell.textLabel.text - person.fullname; 

return cell; 


// Handle cancel by fetching all data 
- (void)searchBarCancelButtonClicked: (UISearchBar *)aSearchBar 
{ 

aSearchBar.text = Q""; 

[dataHelper fetchData] ; 


// Handle search field update by fetching matching entries 
- (void) searchBar: (UISearchBar *)aSearchBar 
textDidChange: (NSString *)searchText 


[dataHelper fetchlItemsMatching:aSearchBar.text 
forAttribute:@"surname" sortingBy:nill; 


// Set up search and Core Data 
- (void) loadView 


| 


self.view - [[UIView alloc] init]; 
self.tableView - [[UITableView alloc] init]; 
self.view.backgroundColor = [UIColor whiteColor]; 


// Create a search bar 
UISearchBar *searchBar = 
[[UISearchBar alloc] initWithFrame: 

CGRectMake(0.0£, 0.0£, 0.0£, 44.0£)]; 
searchBar.autocorrectionType - UITextAutocorrectionTypeNo; 
searchBar.autocapitalizationType - UlTextAutocapitalizationTypeNone; 
searchBar.keyboardType = UIKeyboardTypeAlphabet ; 
searchBar.delegate = self; 
self.tableView.tableHeaderView = searchBar; 


// Create the search display controller 

searchController - [[UISearchDisplayController alloc] 
initWithSearchBar:searchBar contentsController:self]; 

searchController.searchResultsDataSource - self; 

searchController.searchResultsDelegate - self; 


// Establish Core Data 

dataHelper = [[CoreDataHelper alloc] init]; 
dataHelper.entityName = @"Person"; 
dataHelper.defaultSortAttribute = @"surname"; 


// Check for existing data 
BOOL firstRun = !dataHelper.hasStore; 


// Set up Core Data 
[dataHelper setupCoreData]; 
if (firstRum) 


[self initializeData]; 


[dataHelper fetchDatal; 
[self.tableView reloadData]; 


// Hide the search bar 
- (void)viewDidAppear: (BOOL)animated 


| 


[super viewDidAppear:animated]; 

NSIndexPath *path - [NSIndexPath indexPathForRow:0 inSection:0]; 

[self.tableView scrollToRowAtIndexPath:path 
atScrollPosition:UITableViewScrollPositionTop animated:NO]; 


12.9 ”解决 方案 : 为 Core Data 表 格 视 图 添加 编辑 功能 


读者 已 经 看 到 了 如 何 将 表格 视图 与 静态 数据 相 结合 。 现 在 我 们 来 增强 这 项 技术 。 解 决 方案 12-3 演 示 了 怎样 向 表格 界面 里 添加 编辑 功能 ， 并 把 编辑 后 的 数据 存 入 相 
应 的 Core Data 和 存储 区 中 。 


本 条 解决 方案 里 的 大 部 分 代码 ， 读 者 都 应 该 比较 熟悉 了 ， 因 为 第 9 章 在 实现 基本 的 表格 编辑 功能 时 所 用 的 代码 与 此 相似 。 用 户 可 以 点 击 “+” 按 钮 来 添加 新 的 行 ， 
也 可 以 通过 横向 扫 屏 (Swiping) 手 为 或 进入 编辑 模式 来 删除 现 有 的 行 。 剩 下 的 功能 ， 比 如 表格 搜索 与 区 段 率 引 等 ， 都 保持 不 变 。 


本 条 解决 方案 所 用 的 新 数据 ， 都 是 从 一 系列 虚构 的 联系 人 信息 中 加 载 进来 的 ， 感 谢 fakenamegenerator.com 网 站 提供 此 功能 。 用 户 点 击 “+” 按 钮 之 后 ， 程 序 会 
从 这 些 信 息 中 随机 选取 一 个 名 称 ， 并 将 其 添加 到 数据 库 中 。 


如 果 要 把 表格 编辑 功能 添加 到 实际 的 Core Data 程 序 里 ， 那 么 还 应 该 对 范例 代码 做 出 一 定 的 修改 。 比 方 说 ,我 们 可 以 考虑 为 自己 的 表格 添加 撤销 / 重 做 功能 ， 也 可 
以 给 用 户 提供 控制 数据 个 数 的 功能 ， 还 可 以 考虑 通过 控制 器 的 委托 方法 来 更 新 数据 。 


12.9.1 


添加 撤销 / 重 做 功能 


有 了 Core Data 之 后 ， 想 为 表格 添加 撤销 和 重 做 功能 就 简单 得 多 了 。 由 于 Core Data 会 自动 支持 这 些 操作 ， 所 以 开发 者 只 需 编写 非常 少 的 代码 。 创 建 Core Data 环 
境 的 时 候 ， 可 以 为 其 配置 撤销 管理 器 : 


context = [[NSManagedObjectContext alloc] init]; 
 context.persistentStoreCoordinator - persistentStoreCoordinator; 
_context.undoManager = [[NSUndoManager alloc] init]; 
 context.undoManager.levelsOfUndo = 999; 


与 实现 其 他 的 撤销 / 重 做 功能 时 一 样 ， 如 果 主 控制 器 出 现在 屏幕 中 ， 那 么 它 也 必须 成 为 第 一 响应 者 才 行 。 为 此 ， 我 们 需要 实现 下 面 三 个 标准 的 方法 : 
canBecomeFirstResponder, viewDidAppear: 及 viewWillDisappear: 。 第 一 个 方法 返回 YES， 以 响应 系统 的 查询 ; 第 二 个 方法 会 在 控制 器 视图 刚 出 现 的 时 候 立 刻 
令 其 成 为 第 一 响应 者 ; 第 三 个 方法 会 在 控制 器 视图 离开 屏幕 的 时 候 令 其 放弃 第 一 响应 者 的 身份 。 


(BOOL) canBecomeFirstResponder 


return YES; 


(void) viewDidAppear: (BOOL) animated 


[super viewDidAppear: animated] ; 
[self becomeFirstResponder] ; 


if (dataHelper.numberOfEntities == 0) return; 


// Hide the search bar 

NSIndexPath *path = [NSIndexPath indexPathForRow:0 inSection:0]; 

[self.tableView scrollToRowAtIndexPath:path 
atScrollPosition:UITableViewScrollPositionTop animated:NO]; 


- (void)viewWillDisappear: (BOOL)animated 


| 


[super viewWillDisappear:animated] ; 
[self resignFirstResponder] ; 
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来 直接 控制 表格 内 容 ， 所 以 表格 完全 有 可 能 以 不 包含 任何 数据 的 形式 出 现在 屏幕 上 。 


12.9.2 ”创建 撤销 事务 


开发 者 需要 把 修改 对 象 所 用 的 Core Data 语 句 放 在 撤销 群 组 (undo grouping) 之 中 ， 以 便 构成 一 项 撤销 事务 。 修 改 上 下 文 所 用 的 那些 语句 ， 应 该 出 现在 
beginUndoGrouping 下 方 ， 并 放 在 与 之 配套 的 endUndoGrouping 上 方 。 我 们 需要 用 动作 名 称 (action name) 来 的 述 即将 执行 的 操作 。 这 个 动作 名 称 ， 主 要 是 为 晃 
动 撤销 功能 而 设计 的 (比方 说 ， 程 序 里 可 能 会 出 现 “Undo delete? ”字样 ) 。 另 外 ， 它 也 有 助 于 阐明 代码 的 意图 。 


在 下 面 代码 中 ，[dataHelper.context deleteObject: object]; 语句 前 后 的 一 对 花 括号 纯粹 是 为 了 排版 美观 而 添上 去 的 ， 它 们 能 够 凸显 出 其 中 的 语句 是 一 项 事 


务 。 


//| Delete request 
IT 


| 


(editingStyle == UITableViewCellEditingStyleDelete) 


NSManagedObject *object = [dataHelper.fetchedResultsController 


objectAt IndexPath: indexPath] ; 
NSUndoManager *manager = dataHelper.context.undoManager; 
[manager beginUndoGrouping] ; 
[manager setActionName:@"Delete"] ; 


| 


[dataHelper.context deleteObject:object] ; 


| 


[manager endUndoGrouping] ; 


[dataHelper save]; 


上 述 代码 片段 中 的 beginUndoGrouping、setActionName: 及 endUndoGrouping 方 法 调用 ， 可 以 确保 Core Data 能 够 反 转 其 中 的 操作 。 由 于 有 了 Core Data, 


所 以 我 们 只 需 编写 这 几 行 代码 ， 就 可 以 令 应 用 程序 具备 一 套 非常 实用 的 撤销 管理 系统 。 请 注意 ， 应 用 程序 退出 之 后 ， 与 撤销 和 重 做 功能 有 关 的 记录 就 丢失 了 。 因 为 每 
次 局 动 程序 时 ， 它 都 会 重 置 这 个 栈 。 


12.9.3 ”重新 思考 编辑 功能 


在 操作 由 Core Data 所 驱动 的 表格 时 ， 解 决 方案 12-3 不 允许 用 户 重 新 排列 各 行 的 顺序 。 这 是 因为 程序 在 执行 数据 获取 请 求 的 时 候 会 把 数据 排列 好 ， 无 须 用 户 参 


与 。 解 决 方案 12-3 的 tableView: canMoveRowAtindexPath: 方法 会 把 返回 值 写成 硬 代码 NO。 我 们 当然 可 以 再 添加 一 个 表示 行 位 置 的 属性 ， 但 是 大 部 分 情况 下 都 不 
需要 此 功能 。 所 以 ， 解 决 方案 12-3 会 展示 一 种 比较 常见 的 用 法 。 


解决 方案 12-3 ”修改 表格 的 编辑 功能 ， 使 乙 与 Core Data 相 搭配 


// Update items in the navigation bar 
- (void)setBarButtonItems 
// Expire any ongoing operations 
if (dataHelper.context.undoManager.isUndoing || 
dataHelper.context.undoManager.isRedoing) 


[self performSelector:Gselector(setBarButtonItems) 
withObject:nil afterDelay:0.1f]; 
return; 


UIBarButtonItem *undo = SYSBARBUTTON TARGET ( 
UIBarButtonSystemItemUndo, 
dataHelper.context.undoManager, Gselector (undo)); 

undo.enabled = dataHelper.context.undoManager.canUndo; 

UIBarButtonItem *redo = SYSBARBUTTON TARGET( 
UIBarButtonSystemItemRedo, 
dataHelper.context.undoManager, Gselector(redo)); 

redo.enabled - dataHelper.context.undoManager.canRedo; 

UIBarButtonlItem *add - SYSBARBUTTON( 
UIBarButtonSystemItemAdd, Gselector(addItem)); 


self.navigationItem.leftBarButtonItems = @[add, undo, redo]; 


// Refetch data 
- (void) refresh 
| 
// If searching, fetch search results, otherwise all data 
if (searchController.searchBar.text) 
[dataHelper fetchItemsMatching: 
searchController.searchBar.text 
forAttribute:G"surname" sortingBy:nil]; 
else 
[dataHelper fetchData]; 
dataHelper.fetchedResultsController.delegate - self; 


// Reload tables 
[self.tableView reloadData]; 
[searchController.searchResultsTableView reloadData]; 


// Update bar button items 
[self setBarButtonItems]; 


// Respond to section changes 
- (void)controller: (NSFetchedResultsController *)controller 


didChangeSection: (id «NSFetchedResultsSectionInfo»)sectionInfo 


atIndex: (NSUInteger)sectionIndex 
forChangeType: (NSFetchedResultsChangeType)type 


if (type -- NSFetchedResultsChangeDelete) 
[self.tableView deleteSections: 
(NSIndexSet indexSetWithIndex:sectionIndex] 
withRowAnimation:UITableViewRowAnimationAutomatic]; 


if (type == NSFetchedResultsChangeInsert) 
[self.tableView insertSections: 
[NSIndexSet indexSetWithIndex:sectionIndex] 
withRowAnimation:UITableViewRowAnimationAutomatic] ; 
sectionHeadersAffected = YES; 


// Respond to item changes 

- (void) controller: (NSFetchedResultsController *)controller 
didChangeObject: (id) anObject 
atIndexPath: (NSIndexPath *) indexPath 
forChangeType: (NSFetchedResultsChangeType) type 
newlIndexPath: (NSIndexPath *)newIndexPath 


UITableView *tableView - self.tableView; 


if (type == NSFetchedResultsChangeInsert) 
[tableView insertRowsAtIndexPaths:Ge[newIndexPath] 
withRowAnimation:UITableViewRowAnimationAutomatic]; 


if (type == NSFetchedResultsChangeDelete) 
[tableView deleteRowsAtIndexPaths:e[indexPath]l 
withRowAnimation:UITableViewRowAnimationAutomatic]; 


// Prepare for updates 
- (void)controllerWillChangeContent: 
(NSFetchedResultsController *)controller 


sectionHeadersAffected - NO; 


[self.tableView beginUpdates]; 


// Apply updates 
- (void)controllerDidChangeContent: 
(NSFetchedResultsController *)controller 


[self.tableView endUpdates]; 


// Update section headers if needed 
if (sectionHeadersAffected) 
[self.tableView reloadSections: 
[NSIndexSet indexSetWithIndexesInRange: 
NSMakeRange(0, self.tableView.numberOfSections)] 
withRowAnimation:UITableViewRowAnimationNone]; 


[self setBarButtonItems]; 
} 
// Only allow editing on the main table 
- (BOOL)tableView: (UITableView *) aTableView 
canEditRowAtIndexPath: (NSIndexPath *) indexPath 


if (aTableView == searchController.searchResultsTableView) return NO; 
return YES; 


// No reordering allowed 
- (BOOL)tableView: (UITableView *)tableView 
canMoveRowAtIndexPath: (NSIndexPath *)indexPath 


return NO; 


- (void) additem 
{ 
// Surround the "add" functionality with undo grouping 
NSUndoManager *manager = dataHelper.context .undoManager ; 
[manager beginUndoGrouping] ; 
{ 
Person *person = (Person *) [dataHelper newObject] ; 
[self setupNewPerson: person] ; 
} 
[manager endUndoGrouping] ; 
[manager setActionName:@"Add"] ; 
[dataHelper save]; 


// Handle deletions 

- (void)tableView: (UITableView *)tableView 
commitEditingStyle: (UITableViewCellEditingStyle)editingStyle 
forRowAtIndexPath: (NSIndexPath *)indexPath 


// delete request 
if (editingStyle == UITableViewCellEditingStyleDelete) 
{ 
NSManagedObject *object = [dataHelper.fetchedResultsController 
objectAtIndexPath: indexPath] ; 
NSUndoManager *manager = dataHelper.context.undoManager ; 
[manager beginUndoGrouping] ; 


{ 


[dataHelper.context deleteObject:object]; 


[manager endUndoGrouping]; 
[manager setActionName:G"Delete"]; 
[ 


dataHelper savel; 


// Toggle editing mode 
- (void)setEditing: (BOOL)isEditing animated: (BOOL)animated 


| 


[super setEditing:isEditing animated:animated]; 
[self.tableView setEditing:isEditing animated:animated]; 


NSIndexPath *path = [self.tableView 
indexPathForSelectedRow]; 
if (path) 
[self.tableView deselectRowAtIndexPath:path 
animated:YES]; 


[self setBarButtonItems]; 


另外 ， 我 们 也 要 把 数据 库 中 的 改动 与 数据 源 同 步 。 对 于 由 Core Data 所 驱动 的 表格 来 说 ， 这 些 改 动 有 可 能 是 由 用 户 帮 起 的 (比方 说 通过 横向 扫 屏 来 删除 单元 格 ， 通 
过 + 按钮 来 添加 单元 格 等 ) ， 但 也 有 可 能 是 由 撤销 管理 器 执行 的 。 我 们 可 以 通过 委托 来 订 疝 NSFetchedResultsController， 以 获知 是 否 有 数据 因为 撤销 操作 而 发 生变 
化 。 当 数据 有 变化 时 ， 我 们 会 在 NSFetchedResultsControllerDelegate 协 议 的 委托 回调 中 重新 加 载 数据 。 


12.10 ”解决 方案 : 由 Core Data 所 驱动 的 集合 视图 


想 要 把 解决 方案 12-3 从 表格 移植 到 集合 视图 上 面 ， 是 需要 人 花 一 些 工夫 的 ,但 是 工作 量 不 太 大 。 我 们 需要 做 的 是 : 删 近 搜索 视图 控制 器 、 舍 并 率 引 视图 、 略 微 更 新 
一 下 编辑 功能 ， 并 且 把 控制 器 类 从 表格 视图 改 成 集合 视图 。 图 12-3 演 示 了 修改 后 的 效果 。 集 合 控制 器 会 显示 出 与 表格 相同 的 数据 ， 而 且 使 得 用 户 能 够 选 定 并 编辑 单元 
格 ， 同 时 还 具备 撤销 和 重 做 功能 。 


首 移 要 重 构 数据 模型 。 解 决 万 案 12-4 添 加 了 一 个 新 属性 ， 它 是 一 个 二 进 制 数据 项 ， 名 为 imageData。 这 幅 图 像 是 根据 每 个 人 的 名 和 姓 构建 出 来 的 ， 并 以 二 进 制 格 
式 存 储 。 有 了 这 个 属性 ， 集 合 视 图 就 可 以 把 每 条 数据 都 展示 成 一 幅 可 供 重用 的 图 像 了 ， 图 像 的 尺寸 会 与 姓名 相符 。 

所 有 的 数据 源 方法 都 需要 从 表格 视图 迁移 到 集合 视图 。 某 些 方法 所 需 的 改动 非常 少 。 用 于 返回 区 段 数 量 的 方法 以 及 用 于 返回 各 区 段 所 合 条 目 数 量 的 方法 ， 都 会 根 
据 集 合 视 图 做 出 相应 调整 ， 但 是 它们 的 内 部 实现 代码 保持 不 变 。 
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图 12-3 ”解决 方案 12-4 构 建 了 由 Cote Data 所 驱动 的 集合 视图 


其 他 方法 则 需要 做 较 大 改动 。 根 据 路 径 来 提供 单元 格 的 方法 要 彻底 更 新 ， 因 为 集合 视图 是 通过 单元 格 来 展示 图 像 ， 而 不 是 像 表格 视图 那样 只 显示 标题 及 文本 。 解 
决 方案 12-4 没 有 包含 搜索 视图 控制 器 ， 也 没有 包含 与 索引 视图 及 区 段 头 部 有 关 的 回调 。 最 后 ， 解 决 方案 12-4 还 添加 了 一 个 能 够 定制 单元 格 尺 斗 的 布局 方法 ， 以 便 使 每 
个 单元 格 视图 的 大 小 与 其 中 的 图 像 相 符 。 这 个 布局 方法 对 于 集合 视图 来 说 比较 重要 ， 但 在 表格 视图 里 面 却 用 不 到 。 


编辑 功能 也 需要 修改 ， 它 不 再 以 单元 格 的 动画 效果 为 中 心 了 。 所 以 解决 方案 12-4 不 需要 像 表 格 那样 ， 通 过 相关 的 编辑 方法 来 提交 用 户 的 删除 操作 ， 而 是 添加 独立 
的 deleteltem 方 法 ， 该 方法 与 解决 方案 12-3 中 的 addltem 方 法 是 相对 应 的 。 


在 表格 视图 中 ， 导 航 栏 右 侧 的 按钮 用 于 切换 编辑 模式 ， 而 在 集合 视图 中 ， 则 需 改 为 Delete， 以 便 用 户 在 选中 某 单元 格 之 后 ， 通 过 该 按钮 来 删除 它 。 在 由 表格 视图 
迁移 到 集合 视图 的 过 程 中 ， 导 航 栏 里 原 有 的 Undo 与 Redo 按 钮 保持 不 变 ， 支 持 撤销 功能 与 重 做 功能 的 方法 也 保持 不 变 。 


与 采用 MVC 范 式 开发 的 其 他 项 目 一 样 ， 本 例 所 需 的 修改 也 就 这 么 多 了 。Core Data 的 模型 方法 和 解决 方案 12-3 所 用 的 相同 。 视 图 部 分 使 用 UIKit 内 置 的 视图 。 只 有 
控制 器 部 分 需要 调整 ， 或 需要 接收 其 他 更 新 ， 所 以 总 体 来 看 ，MV5C 沁 式 使 得 重 构 的 过 程 变 得 比较 容易 。 


解决 方案 12-4 由 Core Data 所 驱动 的 集合 视图 


#pragma mark Data Source 

// Return the number of sections 

- (NSInteger)numberOfSectionsInCollectionView: 
(UICollectionView *)collectionView 


if (dataHelper.numberOfEntities == 0) return 0; 
return dataHelper.fetchedResultsController.sections.count; 


// Return the number of items per section 
- (NSInteger)collectionView: (UICollectionView *)collectionView 
numberOfItemsInSection: (NSInteger)section 


id «NSFetchedResultsSectionInfo» sectionInfo - 
dataHelper.fetchedResultsController.sections[section]; 
return sectionInfo.numberOfObjects; 


// This method builds images into collection view cells 

- (UICollectionViewCell *)collectionView: 
(UICollectionView *) aCollectionView 
cellForItemAtIndexPath: (NSIndexPath *)indexPath 


UICollectionViewCell *cell = [self.collectionView 
dequeueReusableCellWithReuseIdentifier:G"cell" 
forIndexPath: indexPath] ; 

Person *person = [dataHelper.fetchedResultsController 
objectAtIndexPath:indexPath] ; 

UIImage *image = [UIImage imageWithData:person.imageData] ; 


cell. backgroundColor = [UIColor clearColor]; 
if (![cell.contentView viewWithTag: IMAGEVIEWTAG] ) 
{ 
UIImageView *imageView = 
[[UIImageView alloc] initWithImage:image] ; 
imageView.tag = IMAGEVIEWTAG; 
[cell.contentView addSubview: imageView] ; 


UIImageView *imageView = 
(UIImageView *)[cell.contentView viewWithTag: IMAGEVIEWTAG] ; 


imageView.frame = CGRectMake(0.0f, 10.0f, image.size.width, image.size.height) ; 
imageView.image = image; 
cell.selectedBackgroundView = [[UIView alloc] init]; 


cell.selectedBackgroundView.backgroundColor = 
[UIColor redColor]; 


return cell; 


// Return the size for layout 

- (CGSize)collectionView: (UICollectionView *)collectionView 
layout: (UICollectionViewLayout*)collectionViewLayout 
SizeForItemAtIndexPath: (NSIndexPath *)indexPath 


Person *person - [dataHelper.fetchedResultsController 
objectAtIndexPath:indexPath]; 

UIImage *image - [UIImage imageWithData:person.imageData]; 

return CGSizeMake(image.size.width, image.size.height + 20.0f); 


#pragma mark Delegate methods 
- (void)collectionView: (UICollectionView *)aCollectionView 
didSelectItemAtIndexPath: (NSIndexPath *)indexPath 


[self setBarButtonItems]; 


#pragma mark Editing and Undo 
- (void)setBarButtonItems 
// Delete requires a selected item 
self.navigationlItem.rightBarButtonItem.enabled = 
(self.collectionView.indexPathsForSelectedItems.count !- 0); 


// Set up undo/redo items 
UIBarButtonItem *undo - 
SYSBARBUTTON TARGET (UIBarButtonSystemItemUndo, 
self.dataHelper.context.undoManager, Gselector(undo)); 
undo.enabled = self.dataHelper.context.undoManager.canUndo; 
UIBarButtonItem *redo - 
SYSBARBUTTON TARGET (UIBarButtonSystemItemRedo, 
self.dataHelper.context.undoManager, @selector (redo) ); 
redo.enabled = self.dataHelper.context .undoManager.canRedo; 
UIBarButtonItem *add = 
SYSBARBUTTON (UIBarButtonSystemItemAdd, @selector(addItem) ) ; 


self.navigationItem.leftBarButtonItems = @[add, undo, redo]; 


// Refresh the data, update the view 
- (void) refresh 


[dataHelper fetchData]; 

dataHelper.fetchedResultsController.delegate - self; 

[self.collectionView reloadData]; 

[self performSelector:Gselector(setBarButtonItems) 
withObject:nil afterDelay:0.1f]; 


- (void)controllerDidChangeContent : 
(NSFetchedResultsController *)controller 


// Respond to data change from undo controller 
[self refresh]; 


// Add a new item 

- (void) additem 

{ 
NSUndoManager *manager = dataHelper.context.undoManager ; 
[manager beginUndoGrouping] ; 


| 


Pearann *nerann = (Perann *)[nartraHelnevr neawOhiaeact) - 


[self setupNewPerson:person]; 
j 
[nanager endUndoGrouping]; 
[manager setActionName:QG"Add"]; 
[dataHelper save]; 
[self refresh]; 


// Delete the selected item 
- (void)deleteItem 


{ 


if (!self.collectionView.indexPathsForSelectedItems.count) 


return; 


NSIndexPath *indexPath - 
self.collectionView.indexPathsForSelectedItems[0]; 

NSManagedObject *object - 
[dataHelper.fetchedResultsController 
objectAtIndexPath:indexPath]; 


NSUndoManager *manager - dataHelper.context.undoManager; 
[manager beginUndoGrouping] ; 
{ 
{dataHelper.context deleteObject:object]; 
} 
[manager endUndoGrouping] ; 
[manager setActionName:@"Delete"] ; 
[dataHelper save]; 
[self refresh] ; 


#pragma mark Setup 
- (void) viewDidLoad 
{ 
[super viewDidLoad] ; 
[self.collectionView registerClass: 
[UICollectionViewCell class] 
forCellWithReuseIdentifier:GQ"cell"]; 


self.collectionView.backgroundColor - 
[UIColor lightGrayColor] ; 


self.collectionView.allowsMultipleSelection = NO; 


self.collectionView.allowsSelection - YES; 


self .navigationItem.leftBarButtonItem = 

SYSBARBUTTON (UIBarButtonSystemItemAdd, 

@selector (addItem) ); 
self.navigationItem.rightBarButtonItem = 

BARBUTTON (@"Delete", @selector (deletelItem) ) ; 
self.navigationItem.rightBarButtonItem.enabled = NO; 


1211 小 结 


操作 表格 视图 与 集合 视图 的 时 候 ，Core Data 提 供 了 相当 好 的 支撑 技术 。 它 提供 了 简单 易 用 的 模型 ， 这 些 模型 很 容易 与 UIKit 中 的 数据 源 相 结合 。 本 章 只 是 初步 介 
绍 了 Core Data 的 一 些 能 力 。 其 中 的 解决 方案 演示 了 如 何 设计 并 实现 基本 的 Core Data 功 能 ， 以 便 用 它 来 支持 托管 对 象 模 型 。 我 们 看 到 了 怎样 定义 模型 ， 以 及 怎样 实现 
数据 获取 请 求 。 读 者 也 学 会 了 如 何 添加 对 象 、 修 改 对 象 、 删 除 对 象 及 保存 对 象 。 此 外 ， 还 学 到 了 怎样 使 用 谓词 ， 以 及 怎样 执行 撤销 操作 。 在 阅读 下 一 章 之 前 ， 请 回顾 
以 下 几 个 知识 点 : 


` 如 果 不 把 表格 视图 与 集合 视图 同 Core Data 结 合 起 来 ， 那 就 会 错过 一 种 非常 优雅 的 数据 生成 与 控制 方式 。 


.Core Data 的 使 用 范围 并 不 局 限于 可 以 滚动 的 视图 ， 几 是 表格 状 的 信息 ， 都 可 以 用 Core Data 来 保存 。 它 所 提供 的 关系 型 数据 库 解决 方案 ， 其 能 力 远 远 超出 了 大 部 分 
应 用 程序 的 需求 。 


“ 开发 者 总 是 应 该 提供 撤销 及 重 做 功能 。 就 算 刚 开始 党 得 用 不 到 ， 也 可 以 提前 把 功能 做 好 ， 以 便 将 来 用 到 的 时 候 直接 添加 进去 。 笔 者 并 不 是 特别 欣赏 晃动 撤销 
(shake-to-undo) 这 一 特性 ， 但 如 果 界 面 已 经 很 繁杂 了 ， 那 么 可 以 考虑 用 它 来 向 程序 中 添加 一 种 不 使 用 按钮 的 撤销 功能 。 


` 谓词 是 SDK 中 一 个 很 受 欢迎 的 特性 。 你 应 该 花 些 时 间 研 究 一 下 怎样 构建 谓词 ， 以 及 如 何 用 NSArray 及 NSSet 等 各 种 对 象 来 构建 谓词 ， 而 不 是 仅仅 将 它 与 Core Data 相 


: iCloud 提 供 了 非常 优秀 的 特性 ， 能 够 把 Core Data 和 随处 可 用 的 数据 结合 起 来 ， 使 得 iOS 的 数据 能 够 全 面 延伸 至 用 户 的 桌面 、 设 备 及 云端 。 以 前 ，Core Data 与 iCloud 
结合 得 不 够 稳定 ， 而 且 容 易 出 一 些 问题 ,但 到 了 iOS 7， 苹果 公司 宣称 它 已 经 对 此 做 了 必要 的 改进 。 请 读者 查阅 UIManagedDocument 类 的 开发 文档 ， 以 便 深入 了 解 iCloud 


与 Core Data 的 集成 。 


: Core Data 的 能 力 远 远 不 止 本 章 各 条 解决 方案 所 讲 的 基本 功能 。 请 参阅 Tim Isted 与 Tom Hatrington 所 著 的 《Core Data for iOS: Developing Data-Driven Applications for 


the iPad, iPhone, andiPod touch?» (Addison-Wesley 出 版 ) ， 该 书 详细 地 探 完了 Core Data 及 其 特性 。 


第 13 章 ”网 络 编程 基础 


iPhone 及 iOs 系 列 的 其 他 设备 都 可 以 联网 ， 它 们 非 单 适 合 通过 基于 Web 的 服务 来 获取 远程 数据 。 苹 果 公 司 为 ijOs 平 台 提 供 了 坚实 的 基础 以 构 ， 用 以 实现 各 种 网 络 操 
作 以 及 相关 的 支持 拷 术 。 本 章 讲解 与 网 络 编程 和 有关 的 一 些 基本 技巧 ， 包 括 : 如 何 测试 联网 状态 、 如 何 从 网 站 下 载 数据 ， 以 及 如 何 处 理由 Web 服 务 所 提供 的 传统 形式 数 


据 等 。 


13.1 解决 方案 : 判断 网 络 状态 


联网 的 应 用 程序 在 与 因特网 或 附近 的 设备 通信 时 ， 必 须 有 一 条 活动 的 连接 。 应 用 程序 在 友 送 或 接收 数据 之 前 ， 应 该 知晓 是 否 有 活动 的 连接 可 供 使 用 。 所 以 ， 开 友 
者 需要 判断 网 络 的 状态 ， 使 得 程序 可 以 与 用 户 交流 ， 并 告诉 他 们 某 些 功能 为 何 无 法 使 用 。 


如 果 程 序 在 向 用 户 提 供 下 载 选项 之 前 不 检测 网 络 状态 ， 那 么 苹果 公司 拒绝 这 样 的 应 用 程序 在 App Store 上 架 ， 该 策略 以 后 也 会 延续 下去。 苹果 公 司 的 评审 员 是 经 过 
培训 的 ， 他 们 能 够 判定 程序 有 没有 正确 地 提示 用 户 ， 尤 其 是 当 网 络 出 错时 有 没有 给 出 适当 的 提示 。 开 友 者 总 是 应 该 验证 网 络 的 状态 ， 并 向 用 户 展 示 相 应 的 警示 信息 。 


此 外 ， 苹 果 公 司 还 会 拒绝 那 种 太 耗 费 数 据 流 量 的 程序 。 如 果 在 程序 里 有 大 量 的 数据 要 流动 ， 比 方 说 语音 或 视频 ， 那 么 应 该 判断 当前 的 网 络 类 型 。 如 果 使 用 的 是 移 


动 网 络 (cell network, 1308) ， 那 么 应 该 提供 低 品 质 的 数据 流 ， 若 使 用 WiFi 网 络 ， 则 可 以 提供 高 品质 的 数据 流 。 苹 果 公 司 不 太 能 够 容忍 那 种 在 移动 网 络 之 下 耗费 
较 多 流量 的 程序 。 大 家 要 知道 ， 在 美国 ， 按 流量 计 费 的 收费 方式 已 经 取代 了 不 限 流 量 的 收费 方式 。 如 果 程序 消耗 的 流量 太 多 ， 那 么 用 尸 和 苹果 公司 都 会 对 此 不 满 。 


iOS 可 以 测试 出 是 否 有 某 种 网 络 连 接 可 供 使 用 (无 论 是 何 种 类 型 的 连接 ) 、 是 否 有 WiFi 可 供 使 用 ， 以 及 是 否 有 手机 服务 可 供 使 用 。 目 前 还 没有 一 种 为 App Store 所 
容许 的 API (Application Programming Interface， 应 用 编程 接口 ) 能 够 判断 出 iPhone 是 否 可 以 使 用 蓝牙 连接 ， 不 过 ， 开 发 者 可 以 限定 程序 只 能 运行 在 开启 了 蓝牙 的 
设备 上 。 此 外 ， 开 发 者 在 访问 数据 之 前 ， 也 无 法 判断 出 用 户 是 否 处 在 漫游 状态 ， 以 及 是 否 使 用 了 可 能 比较 昂贵 的 移动 网 络 。 


System Configuration 框 架 提 供 了 网 络 检测 函数 。 在 这 些 函数 中 ，SCNetworkRea-chabilityCreateWithAddress 可 以 判断 设备 是 否 能 够 连通 某 个 IP 地 址 。 解 决 方 
案 13-1 用 一 个 简单 的 范例 演示 了 这 项 测试 。 


networkAvailable 方 法 会 判断 出 设备 是 否 能 对 外 联网 ， 也 就 是 说 ， 设 备 中 是 否 有 能 够 访问 而 且 处 于 活动 状态 的 连接 。 该 方法 借鉴 了 苹果 公司 的 范例 代码 ， 如 果 网 
络 可 以 使 用 ， 束 返回 YES， 否 则 返回 NO。 方 法 里 使 用 了 两 个 标志 ， 以 判断 是 否 有 了 网络 可 达 (kSCNetworkFlagsReachable) ， 以 及 是 否 不 再 需要 建立 网 络 连 接 
(kSCNetworkFlags-ConnectionRequired) 。 可 能 会 用 到 的 其 他 标志 还 有 : 


: kSCNetworkReachabilityFlagslsWWA 


判断 用 户 是 在 使 用 运营 商 的 无 线 广 域 网 络 (Wireless Wide area Network, WWAN) ， 还 是 在 使 用 本 地 WiFi。 如 果 可 
以 使 用 WWAN， 那 么 设备 就 能 通过 EDGE、GPRS、LTIE 或 任意 类 型 的 移动 网 络 来 联网 了 。 在 通过 WWAN 联 网 时 ， 由 于 带宽 或 资费 所 限 ， 开 发 者 可 能 需要 使 用 轻 量 版 的 
资源 (比方 说 ， 尺 寸 较 小 的 图 像 ， 或 是 占用 带宽 较 少 的 视频 ) 。 


- kSCNetworkReachabilityFlagsConnectionOnTraffic 
的 地 址 之 间 进 行 网 络 通 信 ， 那 么 设备 就 会 发 起 连接 。 


该 标志 表示 设备 在 当前 的 网 络 配 置 下 可 以 连接 到 给 定 的 地 址 ， 但 是 必须 先 建立 连接 。 如 果 要 与 给 


KkSCNetworkReachabilityFlagslsDirect 一 一 该 标志 表示 设备 与 给 定 地 址 之 间 的 网 络 通信 是 直达 还 是 经 由 网 关 送 达 。 


判断 网 络 是 否 连通 的 代码 ， 最 好 能 在 多 台 设 备 上 面 测 试 。iPhone 与 能 够 移动 上 网 的 iPad 提 供 了 多 种 上 网 途径 。 这 些 设备 既 可 以 用 移动 网 络 来 上 网 ， 也 可 以 通过 
WiFi 上 网 ， 所 以 ， 当 用 户 使 用 WWAN 连 接 的 时 候 ， 我 们 能 够 确定 网 络 是 可 用 的 。 


在 iPhone 的 “设置 ”里 面 切 换 WiFi 与 移动 网 络 ， 然 后 分 别 测试 解决 方案 13-1 的 代码 。 测 试 网 络 连 通 状 况 时 ， 程 序 可 能 稍 有 延迟 ， 所 以 程序 设计 者 应 该 考虑 到 这 一 
挟 。 我 们 应 当 把 需要 执行 的 检测 告诉 用 户 。 


SCNetworkReachabilityGetFlags 是 一 个 同步 调用 ， 有 可 能 会 长 时 间 阻 塞 线 程 ， 尤 其 是 在 执行 到 DNS (Domain Name System, 域名 系统 ) 查询 这 一 步 的 时 
候 ， 如 果 没 有 网 络 连 接 ， 更 是 会 阻塞 很 长 时 间 。 在 实际 的 应 用 程序 里 ， 绝 不 应 该 在 主线 程 中 调用 这 个 方法 。 如 果 主 线程 延 时 了 很 长 一 段 时 间 ， 那 么 iOs 的 watchdog 可 


能 会 令 程序 终止 。 
我 们 可 以 通过 NSOperationQueue 把 这 个 阻塞 式 的 调用 从 主线 程 里 移 走 。 但 是 要 注意 ， 与 UI 有 关 的 交互 操作 还 是 要 回 到 主线 程 上 面 执行 
[[[NSOperationQueue alloc] init] addOperationWithBlock: 


4 


// blocking call 
BOOL networkAvailable - [device networkAvailable]; 


// UI interaction 
[[NSOperationQueue mainQueue] addOperationWithBlock:^| 


textView.text = networkAvailable ? @"Yes" : @"No"; 


wy 
wd 
- 


BE 


开发 者 可 以 在 共享 的 应 用 程序 实例 上 面 设置 hetworkActivityIndicatorVisible 属 性 ， 用 以 表明 本 程序 是 否 在 使 用 网 络 。 如 果 正 在 联网 ， 那 么 状态 栏 上 会 有 个 旋转 的 


指示 器 。 


解决 方案 13-1 测试 网 络 是 否 连通 


SCNetworkReachabilityRef reachability; 
SCNetworkConnectionFlags connectionFlags; 


- (void)pingReachability 
| 
if (!reachability) 
| 
BOOL ignoresAdHocWiFi - NO; 
struct sockaddr in ipAddress; 
bzero(&ipAddress, sizeof(ipAddress)); 
ipAddress.sin len = sizeof (ipAddress) ; 
ipAddress.sin family = AF _ INET; 
ipAddress.sin addr.s addr = 
htonl (ignoresAdHocWiFi ? INADDR ANY : IN LINKLOCALNETNUM); 


reachability - SCNetworkReachabilityCreateWithAddress( 
kCFAllocatorDefault, (struct sockaddr *)&ipAddress); 
CFRetain(reachability); 


// Recover reachability flags 

BOOL didRetrieveFlags = SCNetworkReachabilityGetFlags ( 
reachability, &connectionFlags); 

if (!didRetrieveFlags) 
NSLog(G"Error. Could not recover network reachability flags"); 


- (BOOL)networkAvailable 


| 


[[UIApplication sharedApplication] 
setNetworkActivityIndicatorVisible:YES]; 
[self pingReachabilityl; 
BOOL isReachable - 
(connectionFlags & kSCNetworkFlagsReachable) !- 0; 
BOOL needsConnection - 
(connectionFlags & kSCNetworkFlagsConnectionRequired) != 0; 
[[UIApplication sharedApplication] 


setNetworkActivityIndicatorVisible:NO] ; 
return (isReachable && !needsConnection) ? YES : NO; 


}} 
获取 解决 方案 代码 


访问 https://github.com/erica/iOS-7-Cookbook 网 页 ， 并 打开 “C13Networking” 文 件 夹 ， 即 可 找到 与 本 章 中 的 解决 方案 相对 应 的 完整 范例 项 目 。 


13.2 ”监测 联网 状况 是 否 友 生变 化 


应 用 程序 运行 的 时 候 ， 其 联网 状态 可 能 会 改变 。 如 果 程 序 在 整个 生命 期 都 需要 使 用 数据 连接 ， 那 么 只 在 刚 局 动 时 判断 是 否 联 网 是 不 够 的 。 在 网 络 连 接 断 开 或 建立 
好 的 时 候 ，UI 应 该 做 出 相应 调整 ， 比 方 说 可 以 禁用 或 局 用 某 个 按钮 ， 也 可 以 向 用 户 展 示警 告 信息 。 


程序 清单 13-1 扩 充 了 UIDevice 类 ， 在 名 为 Reachability 的 category 里 面 ， 提 供 了 监控 联网 状况 是 否 发 生变 化 的 功能 。 其 中 的 两 个 方法 ， 分 别 用 来 排 定 并 解除 网 络 
状况 监视 器 (reachability watcher) 。 这 些 监视 器 会 在 联网 状态 发 生变 化 的 时 候 得 到 通知 。 这 段 代 码 构建 了 名 为 ReachabilityCallback 的 回调 ， 如 果 网 络 状 态 有 变 
化 ， 那 么 它 就 会 向 监视 器 对 象 友 送 消 息 。 监 视 器 安排 在 当前 的 运行 循环 (run loop) 上 面 ， 而 且 以 异步 方式 执行 。 检 测 到 变化 之 后 ， 系 统 会 触 上 回调 函数 。 


程序 清单 13-1 的 回调 函数 又 会 调用 reachabilityChanged 方 法 ， 它 是 我 们 目 定 义 的 委托 方法 ， 监 视 器 必须 实现 该 方法 。 监 视 器 对 象 收 到 通知 之 后 ， 可 以 查询 当前 的 
网 络 状态 。 


排 定 监 视 器 的 方法 会 把 委托 传 给 scheduleReachabilityWatcher: 的 watcher 参 数 。 解 决 方案 13-1 所 实现 的 reachabilityChanged 人 方法 非常 简单 ， 它 只 是 依照 程序 
清单 13-1 的 框架 编写 出 来 的 。 在 开发 真实 的 程序 时 ， 我 们 需要 修改 GUI 里 面 与 网 络 有 关 的 功能 ， 以 便 与 当前 的 联网 状况 相 匹 配 。 如 果 联 网 状态 变 了 ， 应 该 告知 用 户 ， 
并 根据 当前 状态 来 更 新 程序 界面 。 如 果 程 序 无 法 联网 ， 那 么 可 能 要 将 依赖 网 络 的 按钮 和 菜单 项 禁用 。 此 外 ， 也 应 该 给 用 户 展示 某 种 形式 的 警示 信息 ， 告 诉 他 们 GUI 为 什 
LET. 


程序 清单 13-1 ”监控 联网 状态 的 变化 


@protocol ReachabilityWatcher «NSObject» 
- (void) reachabilityChanged; 
@end 


// For each callback, ping the watcher 

Static void ReachabilityCallback ( 
SCNetworkReachabilityRef target, 
SCNetworkConnectionFlags flags, void* info) 


@autoreleasepool { 
id watcher = (_ bridge id) info; 


if ([watcher respondsToSelector: @selector (reachabilityChanged) ] ) 


[watcher performSelector: @selector(reachabilityChanged) ] ; 


| 


// Schedule watcher into the run loop 
- (BOOL)scheduleReachabilityWatcher: (id «ReachabilityWatcher»)watcher 


| 


[self pingReachabilityl; 


SCNetworkReachabilityContext context - 
(0, (_ bridge void *)watcher, NULL, NULL, NULL}; 
if (SCNetworkReachabilitySetCallback (reachability, 
ReachabilityCallback, &context) ) 


if (!SCNetworkReachabilityScheduleWithRunLoop ( 
reachability, CFRunLoopGetCurrent () , 
kCFRunLoopCommonModes) ) 


NSLog(@"Error: Could not schedule reachability"); 
SCNetworkReachabilitySetCallback (reachability, NULL, NULL); 
return NO; 


| 


else 


{ 


NSLog(G"Error: Could not set reachability callback"); 
return NO; 


| 


return YES; 


| 


// Remove the watcher 
- (void) unscheduleReachabilityWatcher 


| 


SCNetworkReachabilitySetCallback(reachability, NULL, NULL); 
if (SCNetworkReachabilityUnscheduleFromRunLoop ( 
reachability, CFRunLoopGetCurrent(), 
kCFRunLoopCommonModes) ) 
NSLog(G"Success. Unscheduled reachability"); 
else 
NSLog(G"Error: Could not unschedule reachability"); 


CFRelease (reachability); 
reachability - nil; 


要 做 好 接收 多 次 回调 的 准备 。 对 于 每 一 种 状态 变化 (也 就 是 指 移动 网 络 的 建立 与 断 开 ) 或 WiFi 的 创建 与 断 开 来 说 ,程序 通 党 只 会 在 同一 时 间 收 到 一 次 回调 。 然 而 
用 户 的 网 络 设置 (尤其 是 记 住 并 自动 登录 已 知 的 WiFi 网 络 ) 可 能 会 影响 回调 的 种 类 与 次 数 ， 所 以 开 友 者 可 能 需要 处 理 多 次 回调 。 


13.3 URL 加 载 系统 


苹果 公司 提供 了 一 套 健 壮 的 APl 栈 ， 用 于 执行 网 络 通信 。 这 个 栈 自 下 至 上 的 每 一 层 ， 包 括 BSD Sockets 层 、 基 于 C 语 言 的 CoreFoundation 层 ， 以 及 基于 Objective- 
C 的 Foundation 层 ， 都 可 以 供 开发 者 调用 。 对 于 客户 端 程 序 来 说 ， 很 少 需要 调用 比 Foundation 更 低 的 层 。 


大 多 数 应 用 程序 都 可 以 使 用 Foundation 层 里 提供 的 URL 加 载 系统 进行 网 络 通 信 。 只 要 某 服务 可 以 通过 URL 访 问 ， 开 发 者 束 能 够 用 这 个 系统 来 连接 、 下 载 及 上 传 数 
据 。 此 功能 并 不 局 限于 HTTP 服 务 (包括 http 和 https) ， 它 也 支持 文件 传输 协议 (file transfer protocol, ftp) 、 本 地 文件 URL 以 及 数据 URL。 


URL 加 载 系统 从 一 开始 就 包含 在 iOS SKZP., NSURLConnection (URLZERZ) 这 个 字眼 ， 无 论 是 作为 技术 名 还 是 作为 类 名 ， 都 令 人 困惑 ， 不 过 ， 很 多 应 用 程序 
都 要 依靠 它 来 执行 各 种 繁杂 的 网 络 操作 。 这 个 框架 本 来 是 给 Safari 浏 览 器 构建 的 ， 后 来 迁移 到 了 Foundation。 


为 了 使 NSURLConnection 变 得 更 加 灵活 、 更 易 配 置 目 更 为 健壮 ， 苹 果 公 司 在 iOS 7 中 彻底 修订 了 这 个 类 。 新 技术 叫 作 NSURLSession ， 该 类 完全 能 够 取代 原 有 的 
类 ， 而 且 对 其 做 了 大 幅度 的 改进 ， 使 开发 者 可 以 更 为 精准 地 配置 它 、 更 好 地 处 理 验证 事宜 、 更 加 方便 地 设置 丰富 的 委托 模型 ， 并 是 能 够 轻松 地 访问 由 iOS 7 引入 的 后 台 
下 载 功 能 。 虽 说 原 有 的 NSURLConnection 系 统 仍然 可 以 使 用 ， 但 我 们 应 该 改 用 新 的 NSURLSession 技 术 。 


NSURLConnection 所 使 用 的 很 多 类 依然 会 用 在 NSURLSession 里 面 ， 比 方 说 NSURL、NSURLRequest 及 NSURLResponse 等 ， 另 外 ，NSURLSession 还 增加 了 一 
些 新 的 类 ， 用 于 实现 配置 ， 并 执行 下 载 数据 和 和 上传 数据 等 任务 。 


13.3.1 fgg 


我 们 要 使 用 NSURLSessionConfiguration 对 象 来 配置 会 话 。 每 次 会 话 (session) 都 使 用 各 自 的 配置 对 象 ， 它 们 会 由 原来 NSURLConnection 所 提供 的 全 局 配置 进 
行 加 强 。 开 发 者 可 以 通过 各 种 属性 来 设置 连接 策略 、 连 接 数 、 数 据 网 络 的 使 用 、 缓 存 、 安 全 凭据 以 及 cookie 存 储 等 。 我 们 可 以 使 用 NSURLSessionConfiguration 类 的 
某 个 工厂 方法 来 创建 配置 对 象 ， 然 后 再 对 其 做 出 相应 的 修改 。 


有 一 个 很 好 的 属性 ， 它 能 够 在 网 络 超时 之 外 指定 整 份 资源 的 超时 。 网 络 超时 (timeoutintervalForRequest) 是 个 “请 求 级 ”的 配置 参数 ， 对 于 由 若干 字 节 所 构成 
的 最 小 传输 单位 来 说 ， 它 指明 了 每 一 小 块 数据 的 超时 。 而 新 的 资源 超时 属性 (timeoutInterval-ForResource) ， 则 指明 了 整 份 数 据 的 传输 超时 。 


配置 好 NSURLSessionConfiguration 对 象 之 后 ， 把 它 传 给 NSURLSession 的 构造 器 。 会 话 中 存储 了 一 份 NSURLSessionConfiguration 的 拷贝 。 把 配置 对 象 传 给 会 
话 之 后 ， 如 果 开发 者 又 修改 了 配置 ， 那 么 所 做 的 修改 是 不 会 生效 的 。 所 以 ， 应 该 在 一 开始 束 把 它 设 定 好 。 


13.3.2 任务 


会 话 中 的 每 个 工作 单元 都 定义 成 NSURLSessionTask 对 象 。 而 “任务 ” 则 是 从 原 有 的 NSURLConnection 类 衍生 出 来 的 一 个 概念 ， 每 项 任务 都 表示 一 次 网 络 请 求 。 
开发 者 能 够 通过 任务 来 获知 该 网 络 请 求 的 当前 状态 。 激 活 任务 之 后 ， 我 们 可 以 用 它 来 取消 、 暂 停 或 继续 某 个 网 络 操 作 。NSURLConnection 里 的 许多 连接 状态 都 需要 实 
现 相关 的 委托 才能 查询 ， 而 现在 ， 我 们 可 以 通过 NSURLSessionTask 的 属性 直接 查询 状态 。 


NSURLSessionTask 是 个 抽象 类 ， 它 有 三 个 具体 类 ， 名 为 NSURLDataTask、NSURLDownloadTask 及 NSURLUploadTask， 分 别提 供 一 般 的 数据 传输 、 下 载 及 上 
传 功能 ， 如 图 13-1 左 图 所 示 。 这 三 种 任务 ， 既 支持 基于 块 的 处 理 程序 ， 又 可 以 通过 更 为 灵活 的 委托 机 制 来 执行 并 处 理 网 络 请 求 。 


NSURLSession Task NSURLSessionDelegate 


NSURLSession 


NSURLSessionDataTask 
| CSSlONn Lata | as To 


NSURLSessionTaskDelegate 


NSURLSessionUpload Task NSURLSessionDataDelegate | NSURLSession 
DownloadDelegate 


图 13-1 与 会 话 相 关 的 一 些 任务 ， 提 供 了 下 载 及 上 传 数 据 的 功能 (如 左 图 所 示 ) 。 而 NSURLSession 也 提供 了 与 之 配套 的 一 些 委托 协议 ， 用 于 获取 及 响应 状态 变更 (WA 
图 所 示 ) 


NSURLsessionTask 的 各 子 类 所 提供 的 功能 基本 相似 ， 然 而 有 几 个 重要 区 别 。NSURLDataTask 是 个 通用 的 基 类 ， 能 够 从 内 存 发 送 数据 ， 也 能 接收 数据 。 
NSURLUpload-Task 与 之 相似 ( 它 实际 上 就 是 NSURLDataTask 的 子 类 ) ， 但 是 提供 了 一 些 与 状态 有 关 的 委托 调用 ， 而 且 可 以 使 用 后 台 传 输 功 能 (参见 解决 方案 13- 
5) 。NSURLDownloadTask 会 把 收 到 的 数据 直接 存 入 文件 ， 并 且 人 允许 程序 从 上 次 取消 或 失败 的 地 方 继续 下 载 。 


13.3.3 NSURLSession 


在 新 的 URL 加 载 系统 中 ， 会 话 保存 了 当前 的 配置 ， 并 且 充 当 创 建 任务 的 工厂 。 这 些 存 续 时 间 比 较 长 的 对 象 ， 应 该 在 处 理 多 项 网 络 任务 的 过 程 中 始终 保持 活动 状态 。 
创建 会 话 的 时 候 有 两 种 办 法 ， 一 种 是 使 用 类 的 构造 器 来 获取 默认 的 会 话 ， 另 一 种 是 创建 目 定 义 的 会 话 。 这 两 种 办 法 的 主要 区 别 在 于 ， 默 认 的 会 话 使 用 共享 的 配置 (该 


配置 与 旧 的 NSURLConnection 所 使 用 的 共享 栈 相同 ) ， 而 自 定义 的 会 话 则 可 以 使 用 开发 者 自己 定制 的 私有 配置 。 


NSURLSession 使 用 同一 个 委托 来 处 理 整 个 栈 中 的 各 种 回调 ， 如 图 13-1 右 图 所 示 。 这 些 委托 协议 包括 NSURLSessionDelegate、NSURLSessionTaskDelegate、 
NSURLSessionDataDelegate 及 NSURLSessionDownloadDelegate。 解 决 方案 13-3 会 进一步 讲解 这 些 委托 的 用 法 。 


用 完 会 话 之 后 ， 要 调用 invalidateAndCance| 方 法 令 该 会 话 失效 ， 并 且 了 立刻 取消 尚未 完成 的 任务 。 也 可 以 调用 finishTasksAndlinvalidate， 该 方法 会 立刻 返回 ,而 
没有 执行 完 的 任务 则 会 继续 执行 下 去 。 当 任务 取消 或 完成 之 后 ， 系 统 会 把 指向 委托 对 象 和 回调 的 引用 清理 并 释放 掉 。 会 话 对 象 一 旦 失效 ， 就 不 能 再 使 用 了 。 


13.4 解决 万 案 : 简单 的 下 载 


许多 类 都 提供 了 一 些 便捷 的 方法 ， 使 得 开 友 者 可 以 从 因特网 中 下 载 数据 ， 并 等 竺 数据 接收 完毕 ， 然 后 再 执行 接 下 来 的 操作 。 下 面 这 段 代码 是 同步 执行 的 ， 而 且 会 
阻塞 当前 的 线程 : 


人 


(UIImage *)imageFromURLString: (NSString *)urlstring 


// This is a blocking call 
return [UIImage imageWithData: [NSData 
dataWithContentsOfURL: [NSURL URLWithString:urlstring] ]]; 


在 接收 完 所 有 数据 之 前 ， 上 述 方法 不 会 返回 。 如 果 网 络 连 接 卡 住 了 ， 那 么 应 用 程序 也 会 失去 响应 。 若 程序 阻塞 主线 程 的 时 | 间 过 久 ， 则 iOS 系 统 的 watchdog 会 立刻 
终止 该 程序 ， 而 不 会 任 其 一 直 卡 在 那里 。 


不 要 企 主线 程 上 面 使 用 这 种 便捷 方法 ， 而 是 应 该 将 其 移 到 后 台 绪 程 去 执行 (解决 方案 13-1 融 是 这 样 做 的 ) 。 


这 些 辅助 方法 写 起 来 很 简单 ， 用 起 来 也 很 容易 ， 然 而 它们 却 不 够 灵活 ， 控 制 能 力也 不 强 ， 开 友 者 无 法 追 叶 下载 进度 、 无 法 暂停 数据 传输 ， 也 不 能 设置 安全 凭据 。 
如 果 想 完 


全 控制 下 载 的 过 程 ， 并 且 设 定 与 之 有 关 的 配置 ， 那 么 应 该 使 用 NSURLSession。 我 们 可 以 使 用 一 系列 委托 回调 ， 也 可 以 使 用 基于 块 的 处 理 程序 。 


解决 方案 13-2 采 用 基于 块 的 办 法 实现 下 载 ， 这 样 简 单一 些 。 我 们 使 用 会 话 对 象 的 工厂 方法 来 创建 NSURLSessionDownloadTask， 并 于 创建 任务 时 传 入 处 理 程序 ， 
以 便 在 任务 完成 后 执行 (1: 


NSURLSessionDownloadTask *task = 


[session downloadTaskWithRequest:request 
completionHandler:^(NSURL *location, 


NSURLResponse *response, 


NSError *error) | // do something }]; 


下 载 完 成 之 后 ， 系 统 会 向 完成 处 理 程序 传 入 下 载 好 的 文件 位 置 、 应 答对 象 以 及 错误 对 象 。 然 后 ， 开 发 者 可 以 对 下 载 好 的 文件 进行 处 理 ， 或 将 其 移动 到 更 合适 的 地 
该 文件 一 开始 会 存放 在 临时 的 文件 夹 中 ， 处 理 程序 之 外 的 代码 不 应 该 访问 这 个 临时 文件 。 


方 。 

即便 开发 者 提供 的 URL 完 全 无 效 ， 某 些 网 络 服务 提供 商 也 还 是 会 返回 一 个 有 效 的 网 页 。 我 们 可 以 通过 response 人 参数 来 判断 是 否 出 现 了 这 样 的 情况 。 该 参数 会 指向 
NSURLResponse 对 象 。 此 对 象 中 存放 的 信息 ， 与 URL 连 接 所 返回 的 数据 有 关 ， 包 括 预期 的 内 容 长 度 (expectedContentLength) ， 以 及 系统 所 建议 的 文件 名 
(suggestedFilename) 。 如 果 expectedContentLength 小 于 0， 那 很 可 能 是 网 络 服务 提供 商 返 回 的 数据 与 程序 所 需 的 数据 不 符 : 


NSLog(@"Response expects $d bytes" 


— MEC 


response.expectedContentLength) ; 


解决 方案 13-2 测 试 了 三 个 预先 写 好 的 URL。 其 中 一 个 可 以 下 载 到 比较 小 的 影片 (3MB) ， 另 一 个 可 以 下 载 到 比较 大 的 影片 (32MB) ， 第 三 个 URL 是 伪造 的 ， 用 于 
测试 程序 在 URL 出 错时 的 反应 。 两 个 电影 文件 位 于 Internet Archive (http://archive.org) 网 站 ， 该 网 站 存放 了 大 量 公 共 领 域 的 数据 。 


开 友 者 可 能 想 规 定 只 有 在 使 用 移动 网 络 以 外 的 方式 上 网 时 ， 才 下 载 比较 大 的 影片 。 这 一 条 略 可 以 通过 NSURLsessionConfiguration 对 和 象 来 配置 : 


— 


NSURLSessionConfiguration *configuration 


[NSURLSessionConfiguration defaultSessionConfiguration]; 
configuration.allowsCellularAccess - NO; 


创建 NSURLSession 的 时 候 ， 把 以 下 配置 对 象 传 进 去 : 


NSURLSession *session - 
[NSURLSession sessionWithConfiguration:configuration]; 


解决 方案 13-2 把 完成 处 理 程 序 与 NSURLsessionDownloadTask 结 合 起 来 使 用 ， 这 种 方式 无 法 在 下 载 过 程 中 向 用 户 提供 反馈 信息 。 为 了 解决 此 问题 ， 解 决 方案 13- 
3 使 用 了 更 为 复杂 但 功能 更 加 完备 的 委托 机 制 。 


解决 方案 13-2 简单 的 下 载 


// Large Movie (35 MB) 
#define LARGE MOVIE G"http://www.archive.org/download/N 
BettyBoopCartoons/Betty Boop More Pep 1936 512kb.mp4" 


// Short movie (3 MB) 
define SMALL MOVIE @"http://www.archive.org/download/\ 
Drive-inSaveFreeTv/Drive-in--SaveFreeTv 512kb.mp4" 


// Fake address 
#define FAKE MOVIE V 
Q"http://www.idontbelievethisisavalidurlforthisexample.com" 


// Current URL to test 
"define MOVIE URL [NSURL URLWithString:LARGE MOVIE] 


// Location to copy the downloaded item 
#define FILE LOCATION [NSHomeDirectory () \ 
stringByAppendingString:@"/Documents/Movie.mp4"] 


@interface TestBedViewController : UIViewController 
@end 


@implementation TestBedViewController 
BOOL success; 
MPMoviePlayerViewController *player; 


- (void)playMovie 

{ 
// Instantiate movie player with location of downloaded file 
player = [[MPMoviePlayerViewController alloc] 

initWithContentURL: [NSURL fileURLWithPath:FILE LOCATION] ] ; 

[player.moviePlayer setControlStyle: MPMovieControlStyleFullscreen] ; 
player.moviePlayer.movieSourceType = MPMovieSourceTypeFile; 
player.moviePlayer.allowsAirPlay = YES; 
[player.moviePlayer prepareToPlay] ; 


// Listen for finish state 
[[NSNotificationCenter defaultCenter] addObserverForName: 
MPMoviePlayerPlaybackDidFinishNotification 
object:player.moviePlayer queue: [NSOperationQueue mainQueue] 
usingBlock:^(NSNotification *notification) 
{ 

[[NSNotificationCenter defaultCenter] removeObserver:self 
name:MPMoviePlayerPlaybackDidFinishNotification 
object:nill; 

self.navigationlItem.rightBarButtonItem.enabled = YES; 


)1; 


[self presentMoviePlayerViewControllerAnimated:player]; 


// Perform an asynchronous download 
- (void)downloadMovie: (NSURL *)url 
( 
// Turn on network activity indicator 
[UIApplication sharedApplication].networkActivityIndicatorVisible 
= YRS: 


NSDate *startDate = [NSDate date]; 


// Create a URL request with the URL to the movie 
NSURLRequest *request = [NSURLRequest requestWithURL:url]; 


// Create a session configuration 
NSURLSessionConfiguration *configuration - 


[NSURLSessionConfiguration defaultSessionConfiguration]; 


// Turn off cellular access for this session 
configuration.allowsCellularAccess - NO; 


// Create a session with the custom configuration 


NSURLSession *session - 
[NSURLSession sessionWithConfiguration:configuration]; 


// Create a download task with the block-based convenience 
// handler to fetch the data 
NSURLSessionDownloadTask *task - 
[session downloadTaskWithRequest:request 
completionHandler:^(NSURL *location, 
NSURLResponse *response, NSError *error) { 


// Turn off the network activity indicator 
[UIApplication sharedApplication] 
.networkActivityIndicatorVisible - NO; 


// Upon an error, reset the UI and abort. 


if (error) 

{ 
self.navigationItem.rightBarButtonItem.enabled = YES; 
NSLog(@"Failed download."); 
return; 


// Copy temporary file 

[[NSFileManager defaultManager] copyItemAtURL: location 
toURL: [NSURL fileURLWithPath: FILE LOCATION] 
error:&error]; 


NSLog (@"Elapsed time: $0.2f seconds.", 
[ [NSDate date] timelntervalSinceDate:startDate]); 


// Play the movie 
[self playMoviel; 


)1; 


// Begin the download task 
[task resume]; 


// Respond to the user's request to play movie 
- (void)action 


{ 


self .navigationItem.rightBarButtonItem.enabled = NO; 


// Stop any existing movie playback 
[player.moviePlayer stop]; 
player = nil; 


// Remove any existing data 
if ([[NSFileManager defaultManager] fileExistsAtPath:FILE LOCATION] ) 


{ 


NSError *error; 


if (![[NSFileManager defaultManager] 
removeItemAtPath:FILE LOCATION error:&errorl) 
NSLog(G"Error removing existing data: %@", 
error.localizedFailureReason); 


// Fetch the data 
[self downloadMovie:MOVIE URL]; 


- (void)loadView 


| 


self.view - [[UIView alloc] init]; 
self.view.backgroundColor = [UIColor whiteColor]; 


self.navigationItem.rightBarButtonItem - 
BARBUTTON(G"Play Movie", Gselector(action)); 


@end 


TRAE 


[1] 这 种 处 理 程序 叫 作 完成 处 理 程序 ， 下 同 。 


13.5 解决 万 案 : 在 下 载 过 程 中 提供 反馈 


NSURLSession 提 供 了 基于 块 的 工厂 方法 ， 它 可 以 用 比较 方便 的 完成 处 理 程 序 来 创建 任务 。 任 务 完成 后 ， 我 们 可 以 继续 处 理 数据 ， 或 是 执行 接 下 来 的 操作 。 这 些 方 
法 用 起 来 比较 简单 ， 不 过 ， 有 时候 程序 需要 在 下 载 或 上 传 的 过 程 中 提供 更 多 的 交互 能 力 。 开 发 者 可 以 通过 NSURLSessionDelegate 协 议 及 其 子 协议 来 访问 并 配置 与 任 


务 有 关 的 更 多 内 容 。 这 些 子 协议 不 仪 支持 上 级 协议 中 与 NSURLSession 有 关 的 委托 方法 ， 而 且 还 提供 了 一 般 任 务 (NSURLSessionTask) 、 数 据 任务 
(NSURLSessionDataTask) 或 下 载 任务 (NSURLSessionDownloadTask) 所 特有 的 回调 方法 。 


这 些 委托 提供 了 与 会 话 及 任务 的 进度 或 状态 相对 应 的 数据 。NSURLsession 对 象 有 个 共用 的 委托 对 象 ， 它 既 能 响应 与 会 话 有 天 的 回调 ， 又 能 响应 与 任务 有 天 的 回 


调 。 这 种 做 法 初 看 上 去 有 些 奇 怪 ， 但 是 大 家 要 明白 ， 无 论 给 NSURLsSession 对 象 设 置 何 种 委托 ， 它 都 要 同时 通过 委托 方法 对 会 话 及 对 应 的 任务 做 出 响应 。 


如 果 想 监控 某 项 下 载 任 务 的 状态 ， 那 么 需要 实现 名 为 URLSession: downloadTask: didWriteData: totalBytesWritten: totalBytesExpectedToWrite: 委托 方 


totalBytesWritten 表 示 已 传输 的 字 忆 数 ，totalBytesExpectedToWrite 表 示 忌 共 应 该 传输 多 少 字 节 ， 通 过 这 两 条 信息 ， 我 们 可 以 在 界面 中 构建 出 进度 


法 。 
(已 写 入 的 ) 


也 可 以 在 下 载 任务 上 面 直接 查询 countOfBytesReceived 及 countOfBytesExpectedToReceive 属 性 。 请 注意 ,方法 签名 中 的 “written” 


及 “received” (已 接受 的 ) 可 能 会 令 人 困惑 ， 其 实 它 们 的 意思 相同 ， 指 的 都 是 已 传输 的 字 节 数 。 


用 已 传输 的 字 节 数 除 以 需要 传输 的 字 节 总 数 ， 融 可 以 构建 出 很 有 用 的 状态 字符 串 ， 而 且 还 能 够 算出 进度 百分比 ， 以 便 传 给 UIProgressView : 


int64 t kilobytesReceived = 
downloadTask.countOfBytesReceived / 1024; 


int64 t kilobytesExpected - 
downloadTask.countOfBytesExpectedToReceive / 1024; 


NSString * statusString = [NSString stringWithFormat:@"%lldk of *lldk", 


kilobytesReceived, kilobytesExpected]; 


double progress - (double)kilobytesReceived /(double)kilobytesExpected; 
progressLabel.text - statusString; 


[progressBarView setProgress:progress animated:YES]; 


解决 方案 13-3 的 表格 里 面 列 出 了 一 些 待 下 载 的 


影 ， 用 户 可 以 点 击 表格 视图 中 的 单元 格 ， 以 下 载 对 应 的 电影 。 导 舰 栏 显示 出 了 下 载 进度 ， 而 且 会 实时 更 新 ， 如 图 


13-2 所 示 。 下 载 完成 之 后 ， 用 户 可 以 观看 下 载 的 影片 。 如 果 想 在 一 份 教学 范例 中 实现 多 个 文件 同时 下 载 ， 并 显示 出 它们 的 进度 ， 需 要 编写 相当 复杂 的 代码 。 所 以 ， 解 


决 方案 13-3 限 制 用 户 每 次 只 能 下 载 一 个 文件 。 


Carrier "= 4:53 PM E 
16509k of 23441k Reset 
Drive-in--SaveFreelv_512kb.mp4 


Heady to Flay 
mother goose little miss muffet... 


| own) oad r riLl EC] 


Betty Boop More Pep 1936 51... 


Downloading... 


图 13-2 ”表格 视图 中 列 出 了 许多 下 载 任务 ， 并 显示 出 每 个 任务 的 状态 


Qez 苹果 公司 在 iIOS 7 中 引入 了 NSProgress， 用 以 提供 通用 的 进度 管理 及 进度 汇报 功能 。 由 于 解决 方案 13-3 每 次 只 能 下 载 一 个 文件 ， 而 且 它 所 需 的 状态 汇报 功 
能 也 比较 简单 ， 所 以 我 们 只 需 即 时 更 新 相关 UI。 通 过 与 下 载 任务 相关 的 委托 回调 ， 很 容易 实现 这 一 点 ， 因 此 不 需 借 助 更 加 健壮 且 更 加 复杂 的 NSProgress。NSProgress 擅 
长 追踪 一 组 任务 的 总 体 状态 ， 包 括 那 些 不 太 容 易 了 解 其 进度 的 任务 ， 另外， 使 用 了 NSProgress 之 后 ， 开 发 者 还 可 以 方便 地 通过 KVO (Key-Value Observing， 键 值 对 观 
测 ) 机 制 来 更 新 UI 元 件 ， 以 反映 进度 。 


解决 方案 13-3 ”在 下 载 过 程 中 提供 反馈 


// Helper class to hold information about a movie and its corresponding download 
@interface MovieDownload : NSObject 

@property (nonatomic, strong) NSURL *movieURL; 

@property (nonatomic, strong) NSURLSessionDownloadTask *downloadTask; 

@property (nonatomic, readonly) NSString *localPath; 


@property (nonatomic, readonly) NSString *movieName; 

@property (nonatomic, readonly) NSString *statusString; 

@property (nonatomic, readonly) double progress; 

- (instancetype) initWithURL: (NSURL *)movieURL 
downloadTask: (NSURLSessionDownloadTask *)downloadTask; 

@end 


@implementation MovieDownload 


- (instancetype) initWithURL: (NSURL *)movieURL 
downloadTask: (NSURLSessionDownloadTask *)downloadTask 


self - [super init]; 

if (self) 

{ 
_movieURL = movieURL; 
 downloadTask = downloadTask; 


j 


return self; 


// A local file path for copying our temporary file 
- (NSString *)localPath 
{ 
NSString *localPath = 
[NSString stringWithFormat :@"%@/Documents/%@", 
NSHomeDirectory(), [self.movieURL lastPathComponent] ] ; 
return localPath; 


// Display name in UI 
- (NSString *)movieName 


{ 


return [self.movieURL lastPathComponent] ; 


// Status string based on progress from download task 
- (NSString *)statusString 


{ 


int64 t kReceived = 


self .downloadTask.countOfBytesReceived / 1024; 
int64 t kExpected = 
self .downloadTask.countOfBytesExpectedToReceive / 1024; 
NSString *statusString = 
[NSString stringWithFormat :@"%lldk of $lldk", 
kReceived, kExpected]; 
return statusString; 


} 


// Progress percentage from download task 
- (double) progress 


double progress - (double)self.downloadTask.countOfBytesReceived / 
(double)self.downloadTask.countOfBytesExpectedToReceive; 
return progress; 


j 


@end 


// Large Movie (35 MB) 
#define LARGE MOVIE @"http://www.archive.org/download/ \ 
BettyBoopCartoons/Betty Boop More Pep 1936 512kb.mp4" 


// Medium movie (8 MB) 

«define MEDIUM MOVIE @"http://www.archive.org/download/ \ 
mother goose little miss muffet/\ 
mother goose little miss muffet 512kb.mp4" 


// Short movie (3 MB) 
#define SMALL MOVIE G"http://www.archive.org/download/N 
Drive-inSaveFreeTv/Drive-in--SaveFreeTv 512kb.mp4" 


@interface TestBedViewController : UITableViewController 
<NSURLSessionDownloadDelegate> 
@end 


@implementation TestBedViewController 

{ 
NSMutableArray *movieDownloads; 
NSURLSession *session; 
UIProgressView *progressBarView; 
MPMoviePlayerViewController *player; 
BOOL downloading; 


#pragma mark - NSURLSessionDownloadDelegate 


// Handle download completion from the task 


- (void)URLSession: (NSURLSession *)session 
downloadTask: (NSURLSessionDownloadTask *)downloadTask 
didFinishDownloadingToURL: (NSURL *) location 


NSInteger index = 

[self movieDownloadIndexForDownloadTask:downloadTask]; 
it (index < 0) return} 
MovieDownload *movieDownload = movieDownloads [index] ; 


// Copy temporary file 

NSError *error; 

[[NSFileManager defaultManager] copyItemAtURL: location 
toURL: [NSURL fileURLWithPath: [movieDownload localPath] ] 
error:&error]; 


// Handle task completion 

- (void)URLSession: (NSURLSession *)session 
task: (NSURLSessionTask *)task 
didCompleteWithError: (NSError *)error 


if (error) 
NSLog(G"Task $9 failed: $9", task, error); 


// Update UI 

[progressBarView setProgress:0 animated:NO]; 
self.navigationItem.title = @""; 

downloading = NO; 


// This method is called after didFinishDownloadingToURL 
// Task state is up-to-date and reflects completion. 
[self.tableView reloadData]; 


- (void)URLSession: (NSURLSession *)session 
downloadTask: (NSURLSessionDownloadTask *)downloadTask 
didResumeAtOffset:(int64 t)fileOffset 
expectedTotalBytes:(int64 t)expectedTotalBytes 


// Required delegate method 


// Handle progress update from the task 

- (void)URLSession: (NSURLSession *)session 
downloadTask: (NSURLSessionDownloadTask *)downloadTask 
didWriteData:(int64 t)bytesWritten 
totalBytesWritten: (int64 t)totalBytesWritten 


totalBytesExpectedTowrite: (int64 t)totalBytesExpectedTowrite 


NSInteger index = 

[self movieDownloadIndexForDownloadTask:downloadTask] ; 
if (index < 0) return; 
MovieDownload *movieDownload = movieDownloads [index] ; 


// Update UI 
[progressBarView setProgress:movieDownload.progress animated: YES] ; 
self .navigationItem.title = movieDownload.statusString; 


#pragma mark - UITableViewDatasource 


- (NSInteger)numberOfSectionsInTableView: (UITableView *)tableView 


{ 


NSInteger sectionCount = 1; 
return sectionCount; 


- (NSInteger)tableView: (UITableView *)tableView 
numberOfRowsInSection: (NSInteger)section 


NSInteger rowCount - movieDownloads.count; 
return rowCount; 


- (UITableViewCell *)tableView: (UITableView *)tableView 
cellForRowAtIndexPath: (NSIndexPath *)indexPath 


static NSString *cellIdentifier = QG"Cellldentifier"; 
UITableViewCell *cell - 

[tableView dequeueReusableCellWithIdentifier:celllIdentifier]; 
if (cell ss nil) 
{ 

cell = [[UITableViewCell alloc] 

initWithStyle:UITableViewCellStyleSubtitle 
reuseldentifier:cellIdentifier]; 


// Reset the cell UI 

cell.selectionStyle - UITableViewCellSelectionStyleDefault; 
cell.textLabel.enabled - YES; 

cell.detailTextLabel.enabled - YES; 


// Set our text label to the file name 
cell.textLabel.text - [movieDownloads[indexPath.row] movieName]; 
// Acquire the appropriate download task and check its state 
NSURLSessionDownloadTask *downloadTask - 

[movieDownloads [indexPath.row] downloadTask]; 
if (downloadTask.state == NSURLSessionTaskStateCompleted) 


{ 
j 


else if (downloadTask.state -- NSURLSessionTaskStateRunning) 


{ 
} 


else if (downloadTask.state == NSURLSessionTaskStateSuspended) 


人 


cell.detailTextLabel.text = @"Ready to Play"; 


cell.detailTextLabel.text = @"Downloading..."; 


// If download already in progress, disable suspended cells. 
if (downloading) 
| 
cell.selectionStyle - UITableViewCellSelectionStyleNone; 
(cCell.textLabel setEnabled:NO]; 
[cell.detailTextLabel setEnabled:NO]; 


if (downloadTask.countOfBytesReceived » 0) 


| 


cell.detailTextLabel.text = @"Download Paused"; 


} 


else 


| 


cell.detailTextLabel.text = @"Not Started"; 


return cell; 


#pragma mark - UITableViewDelegate 


- (void)tableView: (UITableView *)tableView 
didSelectRowAtIndexPath: (NSIndexPath *)indexPath 


// Acquire downloadTask and respond to user's selection 
NSURLSessionDownloadTask *downloadTask - 
[movieDownloads[indexPath.row] downloadTask] ; 
if (downloadTask.state == NSURLSessionTaskStateCompleted) 
{ 
// Download is complete. Play movie. 
NSURL *movieURL = 
[NSURL fileURLWithPath: [movieDownloads [indexPath. row] 
localPath]]; 
[self playMovieAtURL:movieURL] ; 


} 


else if (downloadTask.state == NSURLSessionTaskStateSuspended) 


{ 


// If suspended and not already downloading, resume transfer. 


if (!downloading) 

{ 
[downloadTask resume]; 
downloading = YES; 


j 


else if (downloadTask.state -- NSURLSessionTaskStateRunning) 
{ 
// If already downloading, pause the transfer. 
[downloadTask suspend] ; 
downloading = NO; 
} 
[tableView deselectRowAtIndexPath:indexPath animated: YES] ; 
[tableView reloadData]; 


Hpragma mark - Movie Download Handling & UI 


// Helper method to get index of a movieDownload object from array 


- (NSInteger)movieDownloadIndexForDownloadTask: 
(NSURLSessionDownloadTask *)downloadTask 


NSInteger foundIndex - -1; 
NSInteger index = 0; 


for (MovieDownload *movieDownload in movieDownloads) 


| 


if (movieDownload.downloadTask -- downloadTask) 
( 
foundIndex - index; 
break; 
) 
index++; 


j 


return foundIndex; 


// Play movie at the provided URL 
- (void)playMovieAtURL: (NSURL *)url 


{ 


// Instantiate movie player with location of downloaded file 
player = 

[[MPMoviePlayerViewController alloc] initWithContentURL:url]; 
player.moviePlayer.controlStyle - MPMovieControlStyleFullscreen; 
player.moviePlayer.movieSourceType - MPMovieSourceTypeFile; 
player.moviePlayer.allowsAirPlay - YES; 
[player.moviePlayer prepareToPlay] ; 


[self presentMoviePlayerViewControllerAnimated:player] ; 


// Convenience method to add movieDownload objects to our array 
- (void) addMovieDownload: (NSString *)urlString 
{ 
NSURL * url = [NSURL URLWithString:urlString] ; 
NSURLRequest *request = [NSURLRequest requestWithURL:url]; 
NSURLSessionDownloadTask *downloadTask - 
[session downloadTaskWithRequest:request]; 


MovieDownload *movieDownload = [[MovieDownload alloc] 
initWithURL:url downloadTask:downloadTask]; 
[movieDownloads addObject:movieDownload]; 


// Reset the UI, session, and tasks 
- (void)reset 
| 
for (MovieDownload *movieDownload in movieDownloads) 
{ 
// Cancel each task 
NSURLSessionDownloadTask *downloadTask = 
movieDownload.downloadTask; 
[downloadTask cancell; 


// Remove any existing data 
if ([[NSFileManager defaultManager] 
fileExistsAtPath:movieDownload.localPath]) 


NSError *error; 
if (1![[NSFileManager defaultManager] 
removeltemAtPath:movieDownload.localPath 
error:&error]) 
NSLog(G"Error removing existing data: 
error.localizedFailureReason) ; 


$9", 


// Cancel all tasks and invalidate session (releases delegate) 


[session invalidateAndCancel]; 


Session - nil; 


// Create new configuration / session and set delegate 


NSURLSessionConfiguration *sessionConfiguration - 
[NSURLSessionConfiguration defaultSessionConfiguration]; 


session - [NSURLSession 
sessionWithConfiguration:sessionConfiguration 


delegate:self delegateQueue: [NSOperationQueue mainQueue]]; 


// Create the MovieDownload objects 
movieDownloads = [[NSMutableArray alloc] init]; 
[self addMovieDownload:SMALL MOVIE] ; 

[self addMovieDownload:MEDIUM MOVIE]; 

[self addMovieDownload:LARGE MOVIE]; 


// Reset the UI 
[progressBarView setProgress:0 animated:NO]; 
self.navigationlItem.title = @""; 

downloading = NO; 

[self.tableView reloadData] ; 


- (void) viewDidLoad 
{ 
[super viewDidLoad] ; 
self.view.backgroundColor = 
self.navigationItem.rightBarButtonItem = 
BARBUTTON (@"Reset", @selector (reset) ) ; 


[UIColor whiteColor] ; 


// Set up the progress bar in the navigation bar 
progressBarView = [[UIProgressView alloc] 
initWithProgressViewStyle:UIProgressViewStyleBar] ; 


progressBarView.frame = CGRectMake(0, 0O, 


self.navigationController.navigationBar.frame.size.width, 4); 


[self.navigationController.navigationBar 


addSubview:progressBarView]; 


[self reset]; 


@end 


继续 下 载 
NSURLsessionDownloadTask 有 个 很 棒 的 功能 ， 就 是 可 以 从 上 次 中 断 的 地 方 继续 下 载 。 如 果 下 载 失 败 ， 那 么 可 以 向 下 载 任务 获取 一 块 续 传 数据 。 当 连接 出 错时 ， 


系统 会 执行 相关 的 回调 ， 而 且 会 通过 [error userlnfo] 字 典 的 NSURLSessionDownloadTaskResume-Data 键 来 提供 这 份 数据 。 开 发 者 也 可 以 取消 下 载 任务 ， 并 通过 块 
处 理 程序 [获取 最 新 的 续 传 数据 : 


[downloadTask cancelByProducingResumeData: ^(NSData *resumeData) { 
// save resume data 


11; 


如 果 想 继续 下 载 数据 ， 就 调用 会 话 对 象 的 downloadTaskWithResumeData: BKdownloadTaskWithResumeData: completionHandler: 方法 ， 并 把 原来 保存 
的 续 传 数据 块 作为 参数 传 进去 ， 这 样 就 可 以 创建 新 的 下 载 任务 了 ， 该 任务 会 从 上 次 中 断 的 地 方 继续 下 载 。 


[1] 以“ 块 ” 的 形式 编写 的 处 理 代码 。 


译 者 注 


13.6 解决 万 案 : 后 全 传输 


自从 有 SDK 以 来 ， 许 多 开发 者 都 希望 当 程序 处 在 后 台 时 ， 系 统 能 够 继续 处 理 下载 任务 或 上 传 任务 。iOS 7 终于 引入 了 这 项 强大 的 功能 。 后 台 传 输 (background 
transfer) 需要 用 到 委托 ， 以 便 投递 事 件 。 开 发 者 可 以 使 用 NSURLSessionUploadTask 及 其 对 应 的 委托 ， 也 可 以 使 用 NSURLSessionDownloadTask 及 其 对 应 的 委托 。 
后 台 传 输 功 能 仅 限 于 HTTP 与 HTTPS 协 议 。 无 论 程序 是 在 前 台 还 是 已 经 切入 后 台 ， 都 可 以 进行 数据 传输 。 


进程 内 的 数据 传输 与 进程 外 的 数据 传输 ， 在 创建 与 处 理 方面 ， 没 有 多 少 区 别 。 开 发 者 都 需要 设 定 会 话 对 象 并 设 定 下 载 任务 ， 然 后 开始 网 络 传输 。 


局 动 后 人 传输 功能 的 关键 在 于 会 话 对 象 是 如 何 配置 的 。 我 们 使 用 NSURLSession-Configuration 中 名 为 backgroundSessionConfiguration: 的 类 构造 器 ， 并 传 入 
独特 的 标识 符 字 串 ， 以 便 将 来 能 够 重新 和 这 个 会 话 对象 相 连 : 


NSURLSessionConfiguration *configuration = 
[NSURLSessionConfiguration 
backgroundSessionConfiguration:@"CoreiOSBackgroundID"] ; 
configuration.discretionary = YES; 


session = [NSURLSession sessionWithConfiguration:configuration 


delegate:self delegateQueue:nill; 


将 配置 对 象 的 discretionary 属 性 设 为 YES， 即 可 使 系统 优化 后 台 传 输 任务 ， 令 其 在 设备 接 入 充电 器 及 连 入 WiFi 网 络 的 时 候 执行 。 


若 想 使 用 后 台 传 输 功 能 ， 则 应 在 创建 应 用 程序 时 执行 上 面 的 代码 ， 以 配置 会 话 对 象 。 如 果 程 序 在 崩 演 之 后 重新 运行 ， 或 是 在 有 后 台 传 输 的 情况 下 退出 并 重新 运 
行 ， 那 么 系统 将 用 后 台 ID 来 重新 创立 会 话 ， 以 便 重 建 上 次 正在 执行 的 后 台 会 话 。 系 统 还 会 立刻 触 必 该 会 话 中 相 天 任务 的 委托 方法 。 你 也 可 以 调用 
getTasksWithCompletionHandler: ， 以 便 直 接 获 取现 存 的 全 部 任务 。 


如 果 应 用 程序 在 前 人 台 ， 那 么 与 传输 进度 及 传输 完成 有 关 的 委托 方法 仍然 会 照常 调用 ， 此 时 的 传输 束 相 当 于 一 次 普通 的 进程 内 下 载 。 程 序 离开 前 台 时 ， 下 载 任务 依 
然 会 继续 。 等 到 完成 之 后 ， 系 统 会 在 后 台 重 新 启动 应 用 程序 。 


Qi Bp AP. Bw, LEAH, J G DARIN A UEBUUT. KG AR ACEGEM LS FPP AP PKS AMIR, BOT VASE PAR HH A 
dE Y. 


在 UIApplicationDelegate 中 ， 我 们 需要 实现 application: handleEvents-ForBackgroundURLSession: completionHandler: 方法 。 当 程序 未 处 在 运行 状态 
时 ， 如 果 传 输 操 作 需 要 执行 验证 ， 或 是 传输 操作 已 经 完成 ， 那 么 系统 将 在 后 台 局 动 应 用 程序 ， 而 且 会 调用 相关 的 委托 方法 。 


时 说 程序 运行 在 后 台 ， 但 它 的 UI 实 际 上 是 完整 的 ， 只 不 过 隐藏 起 来 了 。 开 上 友 者 可 以 根据 刚 下 载 好 的 数据 来 更 新 UIl。 更 新 完 UI 之 后 ， 可 以 抓 取 快照 ， 以 供 任务 切换 
器 (task switcher) 使 用 。 若 想 抓 取 快 照 ， 我 们 可 在 委托 方法 中 先 把 后 台 任 务 处 理 元 ， 并 将 UI 更 新 好 ， 然 后 执行 系统 经 由 completionHandler 参 数 所 传 入 的 块 。 


解决 方案 13-4 使 用 了 解决 方案 13-2 所 编写 的 基本 功能 ， 同 时 还 支持 以 后 台 传 输 的 方式 下 载 数据 。 开 始 下 载 影片 之 后 ， 即 便 程序 退出 或 暂停 ， 数 据 传输 也 依然 不 会 
享 止 。 当 传输 完成 时 ， 我 们 把 电影 保存 起 来 ， 并 且 适 当地 更 新 U1， 以 便 程序 下 次 来 到 前 台 的 时 候 ， 用 户 可 以 看 到 更 新 后 的 样子 。 虽 说 后 台 传 输 API 并 不 允许 开发 者 把 程 
序 自动 带 到 前 人 台 ， 但 正如 解决 方案 13-4 所 示 ， 我 们 可 以 触发 一 条 本 机 通知 (local notification) 。 


解决 方案 13-4 ”后 台 传 输 


// Notify the user of a background transfer completion 
- (void)presentNotification 


| 


UILocalNotification *localNotification - 

[[UILocalNotification alloc] init]; 
localNotification.alertBody = @"Download Complete!"; 
localNotification.alertAction - G"Background Transfer"; 
localNotification.soundName = UILocalNotificationDefaultSoundName; 
localNotification.applicationIconBadgeNumber - 1; 

[[UIApplication sharedApplication] 
presentLocalNotificationNow:localNotification]; 


// Reset the application icon badge on activation 
- (void)applicationDidBecomeActive: (UIApplication *)application 


| 


application.applicationIconBadgeNumber - 0; 


// Handle the background transfer completion event 

- (void)application: (UIApplication *)application 
handleEventsForBackgroundURLSession: (NSString *)identifier 
completionHandler: (void (^) ())completionHandler 


// Update the UI to make it apparent in the task switcher 
tbvc.view.backgroundColor - [UIColor greenColor]; 
tbvc.statusLabel.text = @"BACKGROUND DOWNLOAD COMPLETED!"; 


// Present the local notification to the user 
[self presentNotification] ; 


// Update the task switcher snapshot 
completionHandler () ; 


13.6.1 测试 后 台 传 输 
为 了 测试 后 台 传 输 功能 ， 我 们 应 该 在 开始 下 载 之 后 按 设备 上 的 Home 键 ， 以 便 和 暂停 程序 ， 也 可 以 点 击 导航 栏 中 的 Exit App 按 钮 。 此 按钮 将 调用 abort0 函 数 ， 该 函 
数 会 立刻 终止 应 用 程序 。 (不 要 在 实际 程序 里 使 用 这 个 函数 ， 否 则 会 在 评审 过 程 中 齐 到 拒绝 。) 


等 到 程序 切入 后 台 或 是 终止 之 后 ， 了 立刻 重新 运行 该 程序 ， 此 时 程序 应 该 会 回 到 前 人 台 ， 而 且 其 中 的 下 载 也 会 继续 进行 。 我 们 可 以 再 次 将 其 切入 后 全， 但 是 不 重新 运 
行程 序 ， 一 直 等 数据 在 后 台 传 输 完 毕 。 传 输 完成 之 后 ， 系 统 会 在 后 人 台 局 动 应 用 程序 ， 并 且 显 示 出 一 条 本 机 通知 ， 此 外 ， 在 任务 切换 器 中 ， 我 们 也 可 以 看 到 更 新 之 后 的 
Ul. 


13.6.2 ”Web 服务 
目前 ， 如 果 不 借助 Web 服 务 (网 络 服务 ) 的 话 ， 很 难 构建 出 有 影响 力 的 iOS 应 用 程序 。 互 联网 上 面 的 所 有 数据 ， 无 论 是 公开 的 还 是 私有 的 ， 几 乎 都 通过 Web 服 务 
来 提供 。 


实用 的 网 络 终端 会 通过 包含 消息 的 HTTP 来 运作 ， 而 这 些 消息 则 是 以 JSON 或 XML 来 编码 的 。 许 多 网 站 都 公开 上 发布 了 与 这 些 服务 有 关 的 API。 有 些 API 是 需要 注册 方 
可 使 用 的 ， 不 过 另外 一 些 则 可 以 随意 使 用 。 企 业 私 用 的 Web 服 务 及 其 文 要 ， 只 对 经 过 授权 的 人 员 开 放 。 


苹果 公司 提供 了 一 些 易 于 使 用 的 工具 ， 可 以 下 载 并 处 理 大 部 分 Web 服 务 。URL Loading System 可 以 获取 (get) 并 投递 (post) 数据 ， 而 且 提 供 了 解析 器 ， 以 便 
解释 并 生成 需要 来 回 传递 的 消息 。 


13.7 解决 方案 : 使 用 NSJSONSerialization 类 


使 用 基于 JSON 的 网 络 服务 时 ，NSJSONSerialization 类 是 非常 方便 的 。 开 发 者 只 需 提 供 有 效 的 JSON 容 器 ， 并 在 其 中 放 入 有 效 的 JJON 对 象 即 可 。JSON 容 器 就 是 
数组 或 字典 ， 而 其 中 的 JSJON 对 象 则 可 以 是 字符 串 、 数 组 、 字 典 或 NSNull。isValidJSONObject 方 法 可 以 判断 基 对 象 是 不 是 有 效 的 JSJON 对 象 ， 如 果 它 返回 YES， 就 说 
明 该 对 象 可 以 正确 地 转换 成 JJON 格 式 : 


// Build a basic JSON object 
NSArray *array = G[G"Vall", @"Val2", @"Val3"]; 
NSDictionary *dict = @{@"Key 1":array, 

@"Key 2":array, @"Key 3":array}; 


// Convert it to JSON 
if ([NSJSONSerialization isValidJSONObject:dict]) 
| 
NSData *data - [NSJSONSerialization 
dataWithJSONObject:dict options:0 error:nil]; 
NSString *result - [[NSString alloc] 
initWithData:data encoding:NSUTF8StringEncoding]; 
NSLog(G"Result: $90", result); 


mn 


上 面 代码 将 会 产生 下 列 JSON。 请 注意 ， 显 示 字 上 典 内 容 时 ， 系 统 不 一 定 会 按照 每 个 键 的 字母 顺序 来 打 ED: 


Result: ("Key 2 :["Val1",''7a]23", "Val 3"] , "Key 3", 
Babe ae BY i ug! > A he? Aa "Val3"] í "Key l": ["Vall" . "Val2", "Val3"| ) 


把 JSON 转 为 Objective-C 对 象 同样 容易 。 解 决 方案 13-5 使 用 SONObjectWithData: options: error: 方法 ， 将 表示 JSON 对 象 的 NSData 转 换 成 Objective-C 对 
象 。 这 条 解决 方案 会 从 http://openweathermap.org 网 站 下 载 当 前 的 天 和 气 预报 ， 并 从 返回 的 字典 中 取得 一 份 数组 ， 数 组 里 含有 今后 七 天 的 预报 。 程 序 会 用 这 些 数据 来 
填充 标准 的 表格 视图 。 


解决 方案 13-5 ”JSON 数据 


Hdefine WXFORECAST @"http://api.openweathermap.org/data/2.5/\ 
forecast/daily?q-$0&units-Imperial&cnt-7&mode-json" 
#define LOCATION @"Fairbanks" 


// Return a cell for the index path 
- (UITableViewCell *)tableView: (UITableView *)aTableView 
cellForRowAtIndexPath: (NSIndexPath *) indexPath 


// Top level dictionary for the forecast data 
NSDictionary *top = [items objectAtIndex: indexPath. row] ; 


// The date of this forecast under top 
NSString *unixtime = top[@"dt"]; 


// The weather dictionary that includes the sky description 
NSDictionary * weather = top[@"weather"] [0]; 


// The sky description string under weather 
NSString *wxDescription = weather[G"description"]; 


// Convert the unixtime to something we can use 
NSDate *wxDate = [NSDate dateWithTimeIntervalSincel970: 
funixtime doubleValuel]; 


UITableViewCell *cell = [self.tableView 
dequeueReusableCellWithIdentifier:G$"cell"]; 
if (cell == nil) 
{ 
cell = [[UITableViewCell alloc] 


initWithStyle:UITableViewCellStyleSubtitle 
reuseIdentifier:@"cell"] ; 


} 


cell.textLabel.text = wxDescription; 
cell.detailTextLabel.text - 

[dateFormatter stringFromDate:wxDate]; 
return cell; 


#pragma mark - Web Service Download 


- (void)loadWebService 


{ 


self.title = LOCATION; 


// Start the refresh control 
[self.refreshControl beginRefreshing] ; 
// Create the URL string based on location 
NSString *urlString = 
[NSString stringWithFormat :WXFORECAST, LOCATION]; 


// Set up the session 
NSURLSessionConfiguration * configuration = 
[NSURLSessionConfiguration defaultSessionConfiguration] ; 
NSURLSession *session = 
[NSURLSession sessionWithConfiguration:configuration]; 
NSURLRequest *request - 
[NSURLRequest requestWithURL: [NSURL 
URLWithString:urlString]l]l]; 


// Create a data task to transfer the web service endpoint contents 
NSURLSessionDataTask *dataTask - 
[session dataTaskWithRequest:request 
completionHandler:^(NSData *data, 
NSURLResponse *response, NSError *error) { 


// Stop the refresh control 
[self.refreshControl endRefreshing] ; 


if (error) 


| 


self.title - error.localizedDescription; 
return; 


// Parse the JSON from the data object 
NSDictionary *json - [NSJSONSerialization 
JSONObjectWithData:data options:0 error:nill; 


// Store off the top level array of forecasts 


items = json[G"list"]; 


[self.tableView reloadData]; 


}]; 


// Start the data task 


[dataTask resume]; 


13.8 解决 方案 : 将 XML 转 换 为 树 状 结构 


里 说 许多 Web 服 务 都 开始 使 用 较为 简单 的 SON 格式 了 ， 但 是 XML 作 为 一 种 文档 编码 格式 ， 依 然 很 流行 。iOS 的 NSXMLParser 类 可 以 扫描 XML， 并 且 会 在 开始 处 
理 某 个 新 元 素 以 及 处 理 完 该 元 素 时 创建 回调 (也 就 是 说 ， 它 按照 SAX 和 解析 器 的 通常 逻辑 来 运作 ) 。 如 果 要 从 某 些 简单 的 数据 源 里 面 下 载 一 两 份 相关 的 信息 ， 那 么 这 个 类 
用 起 来 很 合适 。 但 如 果 要 执行 的 操作 依赖 于 错误 检查 、 状 态 信 息 以 及 反复 握手 等 机 制 ， 那 它 也 许 融 不 太 能 胜任 了 。 


解决 方案 13-6 与 解决 方案 13-5 类 似 ， 也 要 从 http://openweathermap.org 网 站 获取 同样 的 天 气 预报 数据 ， 只 不 过 这 次 我 们 使 用 XML 格式 。 它 需要 把 请 求 的 模式 由 
json 改 为 xml， 并 使 用 XML 解析 器 来 填充 其 表格 视图 : 


#define WXFORECAST ^ 
@"http://api.openweathermap.org/data/2.5/\ 
forecast /daily?q=%s@&units=Imperial&cnt=7&mode=xml1" 

#define LOCATION @"Fairbanks" 


- (void) loadWebService 


| 


self.title - LOCATION; 


// Start the refresh control 
[self.refreshControl beginRefreshing]; 


// Create the URL string based on location 
NSString *urlString - 


[NSString stringWithFormat:WXFORECAST, LOCATION]; 


// Set up the session 
NSURLSessionConfiguration * configuration - 
[NSURLSessionConfiguration defaultSessionConfiguration]; 
NSURLSession *session - 
[NSURLSession sessionWithConfiguration:configuration]; 
NSURLRequest *request - 
[NSURLRequest requestWithURL: [NSURL URLWithString:urlStringll; 


// Create a data task to transfer the web service endpoint contents 
NSURLSessionDataTask *dataTask - 
[Session dataTaskWithRequest:request 
completionHandler:^(NSData *data, NSURLResponse *response, 
NSError *error) { 


// Stop the refresh control 
[self.refreshControl endRefreshing]; 
if (error) 
{ 
self.title = error.localizedDescription; 


return; 


// Create the XML parser 
XMLParser *parser = [[XMLParser alloc] init]; 


// Parse the XML from the data object 
root = [parser parseXMLFromData:data]; 


// Store off the top level parent of forecasts 
forecastsRoot = [root nodesForKey:@"forecast"] [0] ; 


[self.tableView reloadData]; 


)1; 


// Start the data task 
[dataTask resume]; 


// Return a cell for the index path 
- (UITableViewCell *)tableView: (UITableView *)aTableView 
cellForRowAtIndexPath: (NSIndexPath *)indexPath 


TreeNode *forecastRoot - forecastsRoot.children[indexPath.row]; 
NSString *day = [forecastRoot attributes] [@"day"] ; 

TreeNode *cloudsNode = [forecastRoot nodeForKey:@"clouds"] ; 
NSString *wxDescription = [cloudsNode attributes] [@"value"] ; 


UITableViewCell *cell - 
[self.tableView dequeueReusableCellWithIdentifier:@"cell"]; 


if (cell -- nil) 


| 


cell = [[UITableViewCell alloc] 
initWithStyle:UITableViewCellStyleSubtitle 
reuseIdentifier:G"cell"]; 


| 


cell.textLabel.text - wxDescription; 
cell.detailTextLabel.text - day; 
return cell; 


13.8.1 树 
树 这 种 数据 结构 很 适合 用 来 表示 XML 数 据 。 开 发 者 可 以 用 XML 数 据 创建 出 一 棵 树 ， 只 要 我 们 能 够 把 数据 正确 地 放 在 内 存 中 ， 残 可 以 通过 树 中 的 搜索 路 径 找 到 自己 
想 要 的 数据 。 我 们 可 以 获取 所 有 元 素 ， 也 可 以 搜寻 某 个 表示 操作 成 功 的 值 ， 等 等 。 树 可 以 把 基于 文本 的 XML 转 化 成 一 种 多 维度 的 结构 。 


为 了 把 NSXMLParser 的 解析 结果 转化 成 树 状 结构 ， 我 们 需要 使 用 一 种 基于 NSXMLParser 的 辅助 类 来 返回 标准 的 树 状 数据 。 而 这 个 辅助 类 又 需要 用 到 下 面 这 种 简单 
AURIS AA: 


@interface TreeNode : NSObject 


@property (nonatomic, weak) TreeNode *parent; 
Gproperty (nonatomic, strong) NSMutableArray  *children; 
Gproperty (nonatomic, strong) NSString *key; 
@property (nonatomic, strong) NSDictionary *attributes; 
@property (nonatomic, strong) NSString *leafValue; 
@end 


这 种 节操 里 面 有 两 个 链接 ， 分 别 用 来 表示 本 节点 的 上 级 节点 和 下 级 节点 ， 以 便 使 开 友 者 能 够 在 树 里 进行 双向 遍历 。 在 这 两 个 链接 中 ， 只 有 从 上 级 节点 指向 下 级 节 
扎 的 引用 是 强 引 用 ， 这 使 得 系统 可 以 回收 树 中 的 内 存 ， 而 无 须 开 发 者 手工 执行 清理 。 


比方 说 ， 我 们 从 http://weathermap.org 网 站 的 Web 服 务 中 获取 了 下 面 这 段 XML 人 代码 (笔者 对 其 做 了 简化 ) : 


<time day="2013-12-01"> 
«clouds value="sky is clear"/> 
</time> 


这 段 有 效 的 XML 将 会 解析 成 两 个 TreeNode 对 象 ， 这 两 个 对 象 的 key 属 性 分 别 是 time 和 clouds。time 节 点 的 children 数 组 将 会 包含 clouds 节 点 。 而 clouds 节 后 的 
parent 属 性 叉 会 指向 time 节 点 。time 节 点 的 attributes 属 性 是 一 份 字 典 ， 其 中 售 有 名 为 day 的 键 ， 该 键 所 对 应 的 值 是 2013-12-01。 与 之 相似 ，clouds 节 点 里 也 会 有 
attributes 字 典 ， 在 该 字典 中 ，value 键 所 对 应 的 值 是 sky is clear, 


13.8.2 ”构建 解析 树 


解决 方案 13-6 设 计 了 XMLParser 类 。 该 类 会 在 NSXMLParser 类 遍历 XML 源 数据 的 过 程 中 构建 出 解析 树 。 在 实现 NSXMLParserDelegate 协 议 中 三 个 标准 的 解析 方 
法 (系统 分 别 会 在 找到 新 元 素 、 解 析 完 现 有 元 素 以 及 找到 字符 的 时 候 回 调 这 三 个 方法 ) 时 ， 该 类 会 读 取 XML 流 ， 并 按照 深度 优先 方式 递归 地 人 遍历 这 棵 树 。 


解决 方案 13-6 XMLParser 辅 助 类 


@implementation XMLParser 
// Parser returns the tree root. Go down 
// one node to the real results 
- (TreeNode *)parse: (NSXMLParser *)parser 
{ 
stack = [NSMutableArray array]; 
TreeNode *root = [TreeNode treeNode] ; 
[stack addObject:root] ; 


[parser setDelegate:self]; 
[parser parse]; 


// Pop down to real root 
TreeNode *realRoot = [[root children] lastObject] ; 


// Remove any connections 
root.children = nil; 
root.leafValue = nil; 
root.key = nil; 
realRoot.parent = nil; 


// Return the true root 
return realRoot; 


- (TreeNode *)parseXMLFromURL: (NSURL *)url 
| 
TreeNode *results - nil; 
Gautoreleasepool { 
NSXMLParser *parser - 
[[NSXMLParser alloc] initWithContentsOfURL:url]; 
results - [self parse:parser]; 


| 


return results; 


- (TreeNode *)parseXMLFromData: (NSData *)data 
| 
TreeNode *results - nil; 
Gautoreleasepool { 
NSXMLParser *parser - 
[[NSXMLParser alloc] initWithData:data]; 
results - [self parse:parser]; 


| 


return results; 


// Descend to a new element 

- (void)parser: (NSXMLParser *)parser 
didStartElement: (NSString *)elementName 
namespaceURI: (NSString *)namespaceURI 
qualifiedName: (NSString *)qName 
attributes: (NSDictionary *)attributeDict 


if (qName) elementName - qName; 


TreeNode *leaf = [TreeNode treeNode] ; 

leaf.parent - [stack lastObject]; 

[(NSMutableArray *)[[stack lastObject] children] addObject:leaf]; 
leaf.attributes - attributeDict; 

leaf.key - [NSString stringWithString:elementName]; 
leaf.leafValue = nil; 

leaf.children = [NSMutableArray array] ; 


[stack addObject:leaf] ; 


// Pop after finishing element 

- (void)parser: (NSXMLParser *) parser 
didEndElement: (NSString *)elementName 
namespaceURI: (NSString *)namespaceURI 
qualifiedName: (NSString *)qName 


[stack removeLastObject]; 


// Reached a leaf 
- (void)parser: (NSXMLParser *)parser 
foundCharacters: (NSString *)string 


if (![[stack lastObject] leafValue] ) 


| 


([stack lastObject] 
setLeafValue: [NSString stringWithString:stringll; 
return 


j 


[[stack lastObject] setLeafValue: 
[NSString stringWithFormat :@"%@%@", 
[[stack lastObject] leafValue], stringl]l; 


} 


@end 


该 类 会 在 发 现 新 元 素 的 时 候 (也 就 是 系统 回调 parser: didStartElement: qualifiedName: attributes: 的 时 候 ) 添加 新 节点 ， 并 且 会 在 找到 文本 的 时 候 (eR 
是 系统 回调 parser: foundCharacters: 的 时 候 ) 添加 叶 值 (leaf value) 。 在 XML 中 ， 同 一 深度 上 可 能 会 有 平 级 的 节点 ， 因 此 ， 该 类 的 代码 要 用 栈 来 记录 当前 节点 与 
根 节点 之 间 的 路 径 。 这 样 的 话 ， 我 们 就 可 以 在 parser: didEndElement: 方法 中 把 具有 相同 上 级 元 素 的 平 级 节点 从 栈 中 弹出 ， 使 得 这 些 节点 能 够 处 在 正确 的 级 别 上 
面 。 


扫描 完 XML 之 后 ，parseXMLFromData: 方法 返回 根 节点 。 


13.9 小结 


本 章 介绍 了 与 网 络 有 天 的 基础 知识 。 读 者 学 到 了 如 何 检测 网 络 连 接 、 如 何 下 载 数据 ， 以 及 如 何在 Objective-C 对 象 与 J3JON 之 间 相 互 转换 。 学 习 下 一 章 之 前 ， 请 先 
回顾 以 下 几 个 知识 点 : 


. 在 苹果 公司 所 提供 的 各 种 网 络 技术 里 面 ， 有 一 些 是 通过 底层 的 C 语 言 例 程 来 实现 的 。 如 果 能 够 找到 与 之 对 应 的 Objective-C 封 装 器 ， 就 应 该 用 封装 过 的 技术 来 纺 
程 ， 以 简化 编码 工作 。 这 么 做 只 有 一 个 缺点 ， 就 是 我 们 无 法 从 最 基础 的 层面 上 紧密 控制 程序 中 的 网 络 操作 ， 但 需要 这 样 做 的 场合 非常 少 。 有 许多 优秀 的 网 络 编程 资 
源 ， 在 网 上 搜 一 下 就 能 找到 。 


iOS 7 提供 了 基于 NSURLSession 的 URL 加 载 系统 ， 这 个 新 的 抽象 系统 的 功能 非常 强大 ， 它 可 以 从 互联 网 下 载 数据 ， 也 可 以 向 互联 网 上 传 数据 。 开 发 者 应 该 尽量 使 
用 这 套 新 的 API 来 编程 。 


-IOS 7 的 后 台 传 输 功 能 很 有 用 ， 它 可 以 令 程 序 及 时 响应 用 户 的 操作 ， 并 向 用 户 展示 出 最 新 的 界面 。 后 侣 传输 技术 可 以 与 OS 7 新 引入 的 无 声 推 技术 (silent push 
notification， 可 以 发 送 通知 以 触发 下 载 操作 ， 但 不 会 出 现 警示 界面 ) 及 后 台 获 取 技 术 (background fetch， 一 种 新 的 后 台 模式 ， 为 频繁 的 后 台 下 载 而 设计 ) 结合 起 来 ， 使 
得 用 户 每 次 启动 应 用 程序 时 ， 总 能 看 到 最 新 的 内 容 。 


` 设备 联网 时 ， 最 重要 的 事情 就 是 要 考虑 到 网 络 错误 。 开 发 者 需要 设计 出 适当 的 应 对 措施 。 我 们 要 检测 网 络 是 否 连通 、 下 载 操 作 是 否 中 断 ， 以 及 收 到 的 数据 是 否 
已 损坏 。 这 些 情况 都 基于 一 项 基本 的 事实 ， 那 就 是 : 程序 所 需 的 数据 并 不 总 是 能 够 获取 到 ， 而 且 获 取 到 的 数据 未 必 就 是 正确 的 。 


C 编写 联网 代码 的 时 候 ， 要 有 “线程 ”这 个 概念 。 如 果 毫 无 顾忌 地 在 主线 程 上 执行 网 络 操作 ， 那 么 系统 很 可 能 会 直接 把 你 的 程序 关 掉 。 块 和 队列 是 两 项 非常 有 用 
的 新 技术 ， 它 们 能 够 使 网 络 应 用 程序 更 加 及 时 地 响应 用 户 。 


第 14 章 ”针对 特定 设备 的 开 友 


每 合 iOS 设 备 都 有 其 特殊 属性 ， 同 时 ， 这 些 设备 之 间 也 有 共同 属性 。 有 些 属性 随时 都 会 改变 ， 有 些 属性 则 一 直 保 持 不 变 。 上 述 属 性 包括 设备 当前 的 物理 方向 、 型 
号 、 电 池 状 态 ， 以 及 能 够 操作 的 硬件 。 本 章 讲 解 设备 的 硬件 规格 以 及 可 供 使 用 的 感应 器 ， 其 中 的 各 条 解决 方案 将 会 给 出 很 多 与 设备 有 天 的 信息 。 读 者 会 学 到 如 何在 程 
序 运 行 的 时 候 判 断 硬件 是 否 符 合 需求 ， 以 及 怎样 在 应 用 程序 的 Info.plist 文 件 里 指定 这 些 硬件 需求 。 你 会 看 到 怎样 通过 Core Motin ARRIR, AREIS 
阅 通知 ， 以 便 在 感应 器 状态 有 变 时 触 上 回调。 我 们 还 会 学 习 如 何 使 用 屏幕 镜像 及 第 二 屏幕 输出 等 功能 ， 以 及 如 何 获取 可 供 记 录 的 设备 。 本 章 涵盖 iPhone、iPad 与 iPod 
touch 的 硬件 、 文 件 系统 及 感应 器 ， 旨 在 告诉 大 家 如 何以 编程 的 方式 利用 这 些 特 性 。 


14.1 访问 基本 的 设备 信息 
UlDevice 类 提供 了 与 设备 有 关 的 一 些 重要 属性 ， 包 括 iPhone、iPad 或 iPod touch 的 型 号 、 设 备 名 称 、OS 名 称 以 及 OS 版 本 。 通 过 这 种 一 站 式 解决 方案 ， 我 们 可 以 


获知 系统 的 一 些 详细 信息 。 每 项 属性 都 要 通过 实例 万 法 来 获取 ， 我 们 需要 用 [UlDevice currentDevice] 获 得 UIDevice 单 例 ， 然 后 在 单 例 上 面 调用 相应 的 实例 万 法 。 


可 以 从 UlDevice 中 获取 的 设备 信息 有 : 


- systemName 该 属性 返回 当前 操作 系统 的 名 称 。 对 于 目前 的 iDS 设 备 来 说 ， 只 有 一 种 系统 运行 在 iDOS 平 台 上 ， 那 就 是 iPhone OS. 虽然 蔷 果 公 司 已 经 将 iPhone 


OS 改名 为 OS, 但 这 个 属性 并 未 随 之 更 新 。 


- systemVersion 该 属性 表示 设备 上 面 安装 的 固件 版 本 ， 比 方 说 4.3、5.1.1、6.0、7.0.2 等 。 


- model 


该 属性 是 个 字符 串 ， 用 来 描述 设备 的 型 号 ， 也 就 是 iPhone、iPad 或 iPod touch。 如 果 iOS 系 统 将 来 能 够 运行 在 新 型 的 设备 上 面 ， 那 么 还 会 有 其 他 字符 串 
用 来 描述 那些 型 号 。localizedModel 提 供 了 该 属性 的 本 地 化 版 本 。 


- Userlnterfaceldiom 


该 属性 表示 当前 设备 的 界面 样式 ， 它 要 么 是 iPhone 式 (iPhone 与 iPod touch) ， 要 么 是 iPadqd 式 。 如 果 蔷 果 公 司 将 来 发 布 了 具有 新 式 界 面 的 
设备 ， 那 么 可 能 还 会 出 现 其 他 属性 值 。 


: name 


该 属性 表示 用 户 在 iTunes 中 给 iPhone 所 起 的 名 字 ， 比 方 说 “Joe siPhone" 3 “Binky” 。 这 个 名 称 也 用 来 创建 设备 的 本 地 主机 名 。 
下 面 举例 说 明 以 上 几 个 属性 的 用 法 : 


UIDevice *device = {UIDevice currentDevice]; 
NSLog(G"System name: $9", device.systemName) ; 
NSLog(G"Model: $6", device.model); 
NSLog(G"Name: $9", device.name); 


在 目前 的 iOs 系 统 中 ， 我 们 可 以 用 一 条 简单 的 布尔 测试 来 判断 设备 的 界面 样式 。 下 面 这 行 代码 可 以 判断 界面 是 不 是 iPad 式 的 : 


#define IS IPAD (UI USER INTERFACE IDIOM() == UIUserInterfaceIdiomPad) 


请 注意 ， 上 面 代码 使 用 了 UI1Kit 中 一 个 很 方便 的 宏一 一 UI USER INTERFACE IDIOM(0。 它 会 判断 UIDevice 能 否 响应 特定 的 选择 子 ， 如 果 可 以 ， 就 返回 [[UIDevice 
currentDeviceluserlnterfaceldiom]， 若 不 能 ， 则 返回 UIUserlnterface-ldiomPhone。 这 项 测试 如 果 失 败 ， 就 可 以 假定 程序 正 运行 在 iPhone 或 iPod touch Fili, 3É 
果 公 司 将 来 若是 推出 一 系列 新 设备 ， 我 们 就 要 修改 上 述 代 码 ， 以 进行 更 详细 的 测试 。 


14.2 添加 设备 能 力 限 制 


把 程序 提交 到 App store 的 时 候 ， 可 以 在 Info.plist 属 性 列表 里 面 指定 程序 的 需求 。 这 些 需 求 将 会 告诉 Tunes 以 及 移动 版 的 App Store 设备 必须 具备 哪些 能 力 ， 才 能 
运行 本 程序 。 


如 果 Info.plist 文 件 里 面 有 UIRequiredDeviceCapabilities 键 ， 那 么 Tunes 及 移动 版 的 App Store 束 会 对 应 用 程序 的 安装 施加 限制 ， 令 其 只 能 安装 在 具备 这 些 能 力 的 
设备 上 面 。 开 发 者 可 以 通过 字符 串 数组 或 字典 来 提供 这 份 列 表 。 


如 果 采 用 数组 来 指明 设备 应 该 具有 的 能 力 ， 那 么 数组 中 的 每 个 元 素 就 表示 设备 必须 要 有 的 一 项 功能 。 若 是 用 字典 ， 则 可 以 明确 规定 设备 必须 具有 或 不 能 具有 的 特 
性 。 字 典 里 的 每 个 键 都 表示 一 种 特性 。 键 所 对 应 的 值 如 果 是 真 ， 融 表示 设备 必须 具备 此 特性 ， 如 果 是 假 ， 则 表示 设备 绝 不 能 具备 此 特性 。 


表 14-1 详 细 列 出 了 摘 述 各 种 设备 特征 的 键 。 只 有 当 程 序 必 须 运行 在 具备 某 特征 的 设备 上 面 ， 或 是 绝 不 能 运行 在 具备 某 特 征 的 设备 上 面 时 ， 我 们 才 应 该 对 其 做 出 限 
。 程 序 如 果 能 够 在 不 具备 时 特征 的 设备 上 面 设法 运行 ， 那 我 们 融 不 应 该 增加 这 条 限制 。 表 14-1 以 肯定 名 了 式 摘 述 了 每 项 特征 。 如 果 我 们 要 规定 设备 绝 不 能 具备 某 特 
那 融 把 对 应 的 意思 反 过 来 解读 ， 比 方 癌 ， 可 以 规定 程序 绝 不 能 运行 在 具备 自动 对 焦 摄 像 头 或 了 螺 仪 的 设备 上 面 ， 也 可 以 规定 程序 绝 不 能 运行 在 文 持 Game Center 
的 设备 上 面 。 


EM 


表 14-1 对 应 用 程序 施加 限制 时 可 以 提 及 的 设备 能 力 


键 
telephony 
wifi 
sms 


still-camera 


auto-focus-camera 


front-facing-camera 
camera-flash 


video-camera 
accelerometer 


gyroscope 


location-services 


= X 
应 用 程序 需要 使 用 Phone 程序 ， 或 是 需要 使 用 tel:/ 格式 的 URL 
应 用 程序 需要 访问 本 地 的 802.11 网 络 。 如 果 开 发 者 要 求 OS 在 运行 程序 的 时 候 
必须 保持 WiFi 连接 ， 需 要 把 UIRequiresPersistentWiFi 作为 顶级 的 键 添加 
到 属性 列表 里 
应 用 程序 需要 使 用 Messages 程序 ， 或 是 需要 使 用 sms:// 格式 的 URL 
应 用 程序 需要 使 用 能 够 拍摄 议 态 限 片 的 摄像 关 ， 而 且 可 以 通过 图 像 选取 
用 这 种 摄像 头 来 拍摄 照片 
应 用 程序 需要 使 用 带 有 自动 对 焦 功 能 的 摄像 头 ， 以 便 进 行 微 距 摄影 (macro 
photography )， 或 是 需要 用 它 来 折 摄 特别 清晰 的 图 像 ， 以 便 检 测 其 中 的 某 些 数据 
应 用 程序 需要 使 用 设备 的 前 置 摄像 头 
应 用 程序 需要 使 用 摄像 头 的 闪光 灯 
应 用 程序 需要 使 用 能 够 录影 的 摄像 头 
除了 使 用 简单 的 UIViewController 方向 事件 之 外 ， 
速 计 有 关 的 反馈 功能 
应 用 程序 需要 使 用 设备 中 的 陀螺 仪 
应 用 程序 需要 使 用 Core Location 框架 中 的 功能 


fis Jr [Al 


应 用 程序 还 要 使 用 与 加 


gps 应 用 程序 需要 使 用 Core Location 框架 ,而 且 要 使 用 更 为 精确 的 GPS 定位 功能 

本 应 用 程序 要 使 用 Core Location 框架 ， 而 且 要 使 用 与 设备 朝向 有 关 的 事件 ， 也 就 
是 说 ， 程 序 想 知道 设备 的 移动 方向 《磁力 仪 是 设备 内 置 的 指南 针 ) 

gamekit 应 用 程序 需要 访问 Game Center (适用 于 iOS 4.1 及 后 续 系 统 ) 

应 用 程序 需要 使 用 内 置 的 麦克 风 ， 或 是 使 用 (苹果 公司 所 认可 的 ) 市 有 麦克 风 
的 配件 

opengles-1 应 用 程序 需要 使 用 OpenGL ES 1.1 

opengles-2 应 用 程序 需要 使 用 OpenGL ES 2.0 

armv6 应 用 程序 只 针对 armv6 指令 集 而 编译 (适用 于 iOS 3.1 及 后 续 系统 ) 

armv7 应 用 程序 只 针对 armv7 指令 集 而 编译 (适用 于 iOS 3.1 及 后 续 系 统 ) 


应 用 程序 需要 通过 蓝牙 使 用 GameKit 的 点 对 点 连接 (适用 于 iOS 3.1 及 后 续 系 统 ) 
应 用 程序 必须 运行 在 具有 低 功 耗 蓝 牙 装置 的 设备 上 面 (适用 于 iOS 5.0 及 后 续 系 统 ) 


peer-peer 


bluetooth-le 


比方 说 ， 某 应 用 程序 可 以 在 具备 摄像 头 的 设备 上 面 提供 拍照 功能 。 如 果 此 程序 也 能 在 不 带 摄像 头 的 早期 iPod touch 上 面 运作 ， 那 么 就 不 要 施加 stil-camera 限 制 ， 
而 是 应 该 在 程序 里 面 判断 设备 有 没有 摄像 头 ， 如 果 有 ， 就 展示 拍照 选项 。 若 施加 了 stil-camera 限 制 ， 会 失去 很 多 使 用 早期 iPod touch (第 一 代 至 第 三 代 ) 及 iPad (第 
一 代 ) 的 潜在 用 户 。 


14.2.1 “提供 垣 述 信息 以 征求 用 户 同感 


为 了 保护 隐私 ， 应 用 程序 在 使 用 日 历数 据 、 摄 像 头 、 联 系 人 、 照 片 、 位 置 等 功能 时 ， 必 须 获 得 终端 用 户 同意 。 而 为 了 使 终端 用 户 能 够 同意 ， 开 发 者 应 该 解释 一 下 
程序 是 如 何 使 用 相关 数据 的 ， 并 且 应 该 描述 出 这 样 做 的 原因 。 在 Info.plist 文 件 中 ， 我 们 可 以 为 下 面 几 个 顶级 的 键 指定 相关 的 字符 串 值 : 

- NSBluetoothPeripheralUsageDescription 

- NSCalendarsUsageDesctiption 

- NSCameraUsageDescription 

- NSContactsUsageDescription 

- NSLocationUsageDescription 

- NSMictophoneUsageDescription 


: NSMotionUsageDesctiption 


: NSPhotoLibraryUsageDesctiption 
: NSRemindersUsageDescription 


当 iOs 向 用 户 征询 特定 资源 的 访问 权时 ， 它 会 把 相关 字符 串 显示 在 标准 的 对 话 框 里 。 


14.2.2 ”Info.plist 文 件 中 其 他 常用 的 键 


下 面 列 出 其 他 常用 的 键 及 其 合 义 ， 这 些 键 可 以 用 在 属性 列表 之 中 : 


- UlFileSharingEnabled (布尔 值 ， 默 认 关 闭 ) 该 属性 使 得 用 户 可 以 从 iTunes 中 访问 应 用 程序 Documents 文 件 夹 下 的 内 容 。 该 文件 夹 出 现在 应 用 程序 沙 盒 的 最 


TRE. 


: UlAppFonts (数组 ， 其 中 每 个 字符 串 都 是 字体 文件 的 名 称 ， 文 件 名 里 也 包含 扩展 名 ) 
种 字体 ， 那 么 可 以 使 用 标准 的 UIFont 调 用 来 访问 它们 。 


该 属性 用 来 指定 app bundle 中 所 包含 的 自 定义 TTF 字 体 。 如 果 添 加 了 这 


- UlApplicationExitsOnSuspend (布尔 值 ， 默 认 关闭 ) 一 一 当 用 户 按 下 Home 键 时 ， 系 统 可 以 把 应 用 程序 直接 终止 ， 而 不 是 将 其 切入 后 台 。 如 果 启 用 了 该 属性 ， 


那么 iDOS 就 会 终止 程序 ， 并 将 其 从 内 存 中 移 除 。 


- UlRequiresPersistentWifi (布尔 值 ， 默 认 关 闭 ) 该 属性 可 以 告诉 OS 系统 : 在 程序 处 于 活动 状态 时 ， 应 该 保持 WiFi 连 接 。 


- UlStatusBarHidden (布尔 值 ， 默 认 关 闭 ) 如 果 启 用 该 属性 ， 当 程序 启动 时 状态 栏 会 隐藏 起 来 。 


- UlStatusBarStyle (字符 串 ， 默 认 是 UlStatusBarStyleDefault) 一 一 设 定 状 态 栏 在 程序 启动 时 的 样式 。 


143 ”解决 方案 : 检查 设备 距离 与 电池 状态 


通过 UIDevice 类 所 提供 的 AP1， 开 发 者 可 以 追踪 设备 的 某 些 特 征 ， 比 方 说 电池 的 状态 以 及 距离 感应 器 (proximity sensor) [的 状态 等 。 解 决 方案 14-1 演 示 了 如 何 
监控 并 查询 这 两 项 特征 。 它 们 都 以 通知 的 形式 来 表达 状态 的 变化 ， 我 们 可 以 在 程序 中 订阅 这 种 通知 ， 以 便 在 特征 发 生变 化 时 得 到 通报 。 


[1] 也 称 “ 接 近 度 感应 器 ”。 译 者 注 


14.3.1 局 用 与 尝 用 距离 感应 踢 
目前 来 说 ， 距 离 感 应 器 是 iPhone 特 有 的 功能 。iPod touch 和 iPad 并 没有 提供 距离 感应 器 。 除 非 我 们 有 强烈 的 理由 要 判断 iPhone 与 用 户 是 否 贴 得 很 紧 (或 离 得 很 
远 ) ， 否 则 距离 感应 器 没有 多 大 用 处 。 


局 用 距离 感应 器 之 后 ， 它 的 主要 任务 融 是 判断 设备 正 前方 是 否 有 比较 大 的 物体 。 如 果 有 ， 融 天 挥 屏幕 ， 并 上 友 送 一 条 通用 的 通知 。 物 体 各 是 远离 设备 ， 屏 幕 则 会 重 
新 碗 起 。 用 户 人 在 打 电 话 时 ， 耳 打 可 能 会 碰 到 屏幕 ， 而 有 了 距离 感应 器 之 后 ， 我 们 融 能 防止 用 户 无 意 间 碰 到 某 个 按钮 或 拔 出 某 个 号 码 。 有 些 手机 保护 牵 设 计 得 不 够 好 ， 
可 能 会 使 iPhone 的 距离 感应 器 无 法 正常 运作 。 


Siri 也 会 使 用 距离 感应 器 。 如 果 把 电话 放 在 耳 米 旁边 ， 它 束 会 记录 下 用 户 所 说 的 问题 ， 并 给 出 答复 。Siri 的 语音 界面 并 不 依赖 于 可 视 的 GUI。 


解决 方案 14-1 演 示 了 如 何在 iPhone 上 使 用 距离 感应 器 。 我 们 用 UlDevice 类 来 切换 距离 感应 器 ， 并 YJ 阅 UlDeviceProximityStateDidChangeNotification 通 知 ， 以 
捕获 状态 变化 。 两 种 状态 分 别 是 on (T) Moff ( 关 ) 。 如 果 UIDevice 的 proximityState 属 性 返回 YES， 就 说 明 距 离 感应 器 已 经 激活 了 。 


14.3.2 ”监控 电池 状态 


我 们 可 以 用 编程 的 方式 来 追 中 电池 及 充电 状态 。 通 过 相关 的 APl， 开 发 者 可 以 知道 电池 的 电量 ， 以 及 设备 是 否 接 入 了 电源 。 电 量 是 个 浮 点 值 ，1.0 表 示 完 全 充 
满 ，0.0 表 示 完 全 耗 尽 。 在 执行 非常 耗 电 的 操作 之 前 ,我们 可 以 通过 这 个 值 了 解 设备 大 概 还 剩 下 多 少 电 。 


比方 说 ， 在 执行 一 大 批 数学 计算 之 前 ， 我 们 想 提醒 用 户 将 设备 接 入 电源 。 此 时 可 通过 UlDevice 来 查询 电量 ， 查 到 的 电量 值 是 以 5% 为 间隔 递 进 的 : 


NSLog(G"Battery level: %0.2£%%", 
[UIDevice currentDevice].batteryLevel * 100); 


充电 状态 有 四 种 取 值 。 设 备 可 能 处 于 正在 充电 的 状态 (charging， 也 就 是 说 ， 正 在 同 电源 相连 ) 、 充 满 电 的 状态 (full) 、 未 接 入 充电 器 的 状态 (unplugged) , 
以 及 不 同 于 上 述 三 种 的 未 知 状态 (unknown) 。 通 过 UlDevice 的 batteryState 属 性 ， 可 以 查 到 充电 状态 


NSArray *stateArray = @[ 
@"Battery state is unknown", 
G"Battery is not plugged into a charging source", 
@"Battery is charging", 
@"Battery state is full"]; 


NSLog(G"Battery state: %0", 
stateArray[[UIDevice currentDevice] .batteryState] ) ; 


这 些 值 并 不 表示 持久 的 状态 ， 应 该 把 它们 看 成 是 对 设备 实际 状态 的 一 种 即时 反映 。 这 些 东 西 不 是 标志 (flag) ， 所 以 不 能 通过 OR (或 ) 运算 组 合成 对 电池 状态 的 


我 们 可 以 在 电池 状态 上 生 改 变 时 响应 通知 ， 以 便 监 控 这 些 状态 。 如 此 一 来 ， 融 可 以 捕获 随时 上 友 生 的 事件 了 。 比 方 阅 ， 电 池 何 时 彻底 充满 电 ， 用 户 何 时 将 设备 接 入 
电源 重新 充电 ， 以 及 用 户 何 时 把 设备 与 电源 断 开 等 。 


把 batteryMonitoringEnabled 属 性 设 为 YE39， 即 可 开始 监控 。 在 监控 期 间 ，UIDevice 类 会 在 电池 状态 或 电量 友 生 变化 时 产生 通知 。 解 决 方案 14-1 订 阅 了 这 两 种 通 
知 。 请 注意 ， 我 们 也 可 以 不 等 接 到 通知 残 直 接 去 检查 这 些 值 。 昌 然 苹果 公司 并 未 承 庄 将 以 何 种 频率 来 投递 关于 电量 变化 的 通知 ， 但 是 大 家 只 要 测试 一 下 这 条 解决 方案 
融会 友 现 ， 通 知 的 投递 频率 还 是 相当 规律 的 。 


解决 方案 14-1 监控 距离 感应 器 及 电池 


// Niew the current battery level and state 
- (void)peekAtBatteryState 
{ 
NSArray *stateArray = @[@"Battery state is unknown", 
@"Battery is not plugged into a charging source", 
@"Battery is charging", 
@"Battery state is full"); 


NSString *status = [NSString stringWithFormat: 
@"Battery state: $9, Battery level: $0.2f$$", 
stateArray[[UIDevice currentDevice].batteryState], 
[UIDevice currentDevice].batteryLevel * 100]; 


NSLog(G"$9", status); 


// Show whether proximity is being monitored 
- (void)updateTitle 


self.title = [NSString stringWithFormat:@"Proximity %@", 
[UIDevice currentDevice] .proximityMonitoringEnabled ? @"On" : e"Off"]; 


// Toggle proximity monitoring off and on 


(void) toggle: (1d) sender 


// Determine the current proximity monitoring and toggle it 

BOOL isEnabled = [UIDevice currentDevice] .proximityMonitoringEnabled; 
[UIDevice currentDevice] .proximityMonitoringEnabled = !isEnabled; 
[self updateTitle] ; 


- (void) loadView 


self.view - [[UIView alloc] init]; 


// Enable toggling and initialize title 
self.navigationItem.rightBarButtonItem - 

BARBUTTON (@"Toggle", Gselector(toggle:)); 
[self updateTitle]; 


// Add proximity state checker 
[(NSNotificationCenter defaultCenter] 
addObserverForName:UIDeviceProximityStateDidChangeNotification 
object:nil queue: [NSOperationQueue mainQueue] 
usingBlock:^(NSNotification *notification) { 
// Sensor has triggered either on or off 
NSLog(@"The proximity sensor $0", 
[UIDevice currentDevice].proximityState ? 
@"will now blank the screen" : @"will now restore the screen"); 


DE 


// Enable battery monitoring 
[(UIDevice currentDevice] setBatteryMonitoringEnabled: YES] ; 


// Add observers for battery state and level changes 
[[NSNotificationCenter defaultCenter] 
addObserverForName:UIDeviceBatteryStateDidChangeNotification 
object:nil queue: [NSOperationQueue mainQueue] 
usingBlock:^(NSNotification *notification) { 
// State has changed 
NSLog(G"Battery State Change"); 
[self peekAtBatteryState] ; 


Fla 


[ [NSNotificationCenter defaultCenter] 
addObserverForName :UIDeviceBatteryLevelDidChangeNotification 
object:nil queue: [NSOperationQueue mainQueue] 
usingBlock:^(NSNotification *notification) { 
// Level has changed 
NSLog(@"Battery Level Change"); 
[self peekAtBatteryState]; 


}]; 


获取 解决 方案 代码 


访问 https://github.com/erica/iOS-7-Cookbook 网 页 ， 并 打开 “C14Device ”文件 夹 ， 即 可 找到 与 本 章 中 的 解决 方案 相对 应 的 完整 范例 项 目 。 


14.3.3 ”判断 设备 是 否 具 有 Retina 显 示 屏 


近年 来 ， 芋 果 公 司 为 很 多 设备 都 丢 配 了 Retina 显 示 屏 ， 只 有 一 些 成 本 较 低 的 设备 没有 升级 。 根 据 苹果 公司 的 说 法 ，Retina 显 示 屏 的 像素 密度 很 高 ， 以 致 人 眼 无 法 
分 辨 出 单个 的 像素 。 应 用 程序 可 以 利用 清晰 度 较 好 的 显示 屏 来 展示 分 辨 率 较 高 的 图 像 。 


UlScreen 类 提供 了 一 种 简单 的 办 法 ， 可 以 判断 当前 设备 有 没有 内 置 Retina 显 示 屏 。 这 种 办 法 就 是 检测 UlScreen 的 scale 属 性 。 在 把 逻辑 坐标 空间 (该 空间 的 坐标 以 
RAR, BhRAIE1/160027) 转换 到 设备 坐标 空间 (该 空间 的 坐标 以 像素 为 单位 ) 时 ， 该 属性 用 来 表示 换算 倍数 。 对 于 标准 的 显示 屏 来 说 ， 这 个 倍数 是 1.0， 
也 融 是 说 ，1 个 点 对 应 1 个 像素 。 而 对 于 Retina 显 示 屏 来 说 ， 这 个 倍数 则 是 2.0， 也 融 是 说 ，1 个 点 会 用 4 个 像素 来 显示 : 


- (BOOL) hasRetinaDisplay 


| 


return ([UIScreen mainScreenl.scale == 2.0f); 


UlScreen 类 还 提供 了 两 个 有 用 的 属性 ， 用 来 表示 显示 区 域 的 尺寸 。bounds 属 性 代表 屏幕 的 外 接 和 矩形 (bounding rectangle) , tCCBrFBBSrrsERuRa. Ht 
表示 屏幕 的 总 大 小 ， 这 与 屏幕 上 是 否 有 状态 栏 、 导 舰 栏 或 标签 栏 等 元 件 无 天 。applicationFrame 属 性 也 是 以 点 来 计量 的 ， 它 表示 应 用 程序 初始 的 视窗 尺寸。 


14.4 解决 方案 : 获取 设备 的 其 他 信息 


开发 者 可 以 通过 sysctlI0 及 sysctlbyname() 来 获取 系统 信息 。 这 些 标 准 的 UNIX 函 数 能 够 向 操作 系统 查询 硬件 及 OS 的 详情 。 读 者 可 以 看 看 Macintosh 上 面 
的 /usWinclude/sys/sysctl.h 头 文件 ， 以 便 了 解 能 够 查询 的 范围 。 访 头 文件 详细 列 出 各 种 音量 ， 这 些 音量 可 以 用 作 这 两 个 函数 的 参数 。 


我 们 可 以 通过 常量 查 出 一 些 关 键 信 息 ， 例 如 系统 的 CPU 个 数 、 可 供 使 用 的 内 存 数量 等 。 解 决 方案 14-2 演 示 了 这 一 功能 。 它 针对 UlDevice 类 编写 category ( 扩 


展 ) ， 以 收集 系统 信息 ， 开 发 者 可 以 调用 category 中 的 一 系列 方法 来 查询 这 些 信息 。 
解决 方案 14-2 ”收集 更 多 的 设备 信息 


@implementation UIDevice (Hardware) 
+ (NSString *)getSysInfoByName: (char *)typeSpecifier 


| 
// Recover sysctl information by name 
size t size; 
sysctlbyname(typeSpecifier, NULL, &size, NULL, 0); 


char *answer = malloc(size) ; 
sysctlbyname(typeSpecifier, answer, &size, NULL, 0); 


NSString *results = [NSString stringWithCString: answer 


encoding: NSUTF8StringEncoding] ; 


free (answer) ; 


return results; 


- (NSString *)platform 


return [UIDevice getSysInfoByName:"hw.machine"]; 


- (NSUInteger)getSysInfo: (uint)typeSpecifier 


size t size - sizeof(int); 

int results; 

int mib[2] = (CTL HW, typeSpecifier)]; 
sysctl(mib, 2, &results, &size, NULL, 0); 
return (NSUInteger) results; 


- (NSUInteger)busFrequency 


return [UIDevice getSysInfo:HW BUS FREQ]; 


- (NSUInteger)totalMemory 


return [UIDevice getSysInfo:HW PHYSMEM]; 


- (NSUInteger)userMemory 


return [UIDevice getSysInfo:HW USERMEM]; 


- (NSUInteger)maxSocketBufferSize 


return [UIDevice getSysInfo:KIPC MAXSOCKBUF]; 


| 


@end 


读者 可 能 会 问 : 既然 UIDevice 类 已 经 提供 了 返回 设备 型 号 的 model 属 性 ， 为 什么 还 要 在 这 个 category 里 编写 platform 方 法 呢 ? 这 是 因为 ， 我 们 可 以 更 加 具体 地 判 
断 出 同一 型 号 下 的 各 类 设备 。 


如 果 用 UIDevice 类 的 model 来 查询 ， 那 么 iPhone 3GS 和 和 iPhone 4S 这 两 种 设备 所 返回 的 型 号 都 是 Phone。 但 如 果 改 用 解决 方案 中 的 platform 方 法 来 查询 ， 那 么 
iPhone 3GS 会 返回 iPhone2，1，iPhone 4S 会 返回 iPhone4，1，iPhone 5 会 返回 iPhone5，1。 这 就 使 我 们 能 够 以 编程 的 方式 把 3GS 同 第 一 代 
iPhone (iPhone1, 1) iPhone 3G 区 分 开 (iPhone1，2) , 


每 种 设备 都 内 置 了 一 些 独 有 的 特征 。 开 发 者 获知 具体 的 iPhone 类 型 之 后 ， 融 可 以 判断 出 该 设备 是 否 具备 辅助 功能 、GPSs 以 及 磁力 仪 等 特征 。 


145 Core Motion 基 础 知识 


Core Motion 框架 可 以 集中 访问 由 iOs 硬 件 所 生成 的 运动 数据 (motion data) 。 它 监控 着 三 个 重要 的 感应 器 : 一 个 是 陀螺 仪 ， 用 以 度量 设备 的 旋转 角度 ; 一 个 是 
磁力 计 ， 用 以 反映 指南 针 的 方位 读数 ;还 有 一 个 是 加 速 计 ， 用 以 探测 设备 在 三 条 坐标 轴 上 的 加 速度 。 此 外 ， 该 框 以 还 提供 了 名 为 设备 动作 的 入 口 ， 可 以 把 上 述 三 种 感 
应 器 集成 到 一 套 监 控 系 统 乙 中 。 


Core Motion 根据 这 些 感 应 器 的 原始 值 来 创建 可 供 开 发 者 使 用 的 读数 ， 这 些 读数 主要 以 力 向 量 (force vector) 的 形式 来 体现 。 可 以 测量 的 条 目 包 括 下 面 这 些 属 
性 : 


attitude 一 一 设备 的 姿态 是 指 设备 相对 于 菜 个 参照 系 的 方向 。attitude 是 以 roll、pitch、 yaw! "ik = Fb RBS 的 ， 角 的 单位 是 弧度 。 


: rotationRate 一 一 旋转 率 是 设备 绕 着 每 条 坐标 轴 旋 转 时 的 速率 。 它 包括 设备 围绕 x 轴 、y 轴 及 z 轴 旋转 时 的 角速度 ， 该 速度 以 每 秒 所 转 过 的 弧度 来 计量 。 


“gravity 一 一 重力 是 当前 设备 受到 普通 的 重力 场 吸引 而 产生 的 加 速度 向 量 。 设 备 的 gravity 要 分 别 沿 着 x、y、z 这 三 条 坐标 轴 来 描述 ， 每 条 坐标 轴 所 用 的 计量 单位 者 
是 g。8g 就 是 地 球 上 标准 的 重力 加 速度 (也 就 是 32 英 尺 1 秒 *， 或 9.8 米 1 秒 *) o 

UserAcceleration 一 一 用 户 加 速度 是 设备 因为 用 户 的 动作 而 产生 的 加 速度 向 量 。 与 glavity 一 样 ，userAcceleration 也 要 分 别 沿 着 x、y\、2z 这 三 条 坐标 轴 来 计量 ， 其 计 
量 单 位 也 是 g。 把 用 户 向 量 与 设备 向 量 登 加 在 一 起 ， 就 是 设备 总 体 的 加 速度 向 量 。 


magneticField 一 一 磁场 是 表示 设备 附近 总 体 磁 场 值 的 向 量 。 它 是 按照 x 轴 、y 轴 及 z 轴 上 面 的 微 特 斯 拉 (microtesla) 来 度量 的 。 此 外 ， 系 统 还 会 给 出 校准 精确 度 
(calibration accuracy) ， 使 得 应 用 程序 可 以 了 解 该 读数 的 准确 程度 。 


[1] 它们 分 别 表 示 设 备 绕 着 x 轴 、y 轴 及 z 轴 旋转 的 角度 。 译 者 注 


14.5.1 ”判断 设备 是 否 支 持 某 种 感应 器 
本 章 前 面 说 过 ， 我 们 可 以 通过 应 用 程序 的 Info.plist 文 件 来 限定 设备 必须 具备 或 绝 不 能 具备 某 种 感应 器 。 另 外 ， 开 发 者 也 可 以 在 程序 里 面 查 询 Core Motion 的 
CMMotionManager 对 象 ， 以 了 解 设备 是 否 支 持 某 种 感应 器 : 


if (motionManager.gyroAvailable) 
[motionManager startGyroUpdates]; 


if (motionManager.magnetometerAvailable) 
[motionManager startMagnetometerUpdates]; 


if (motionManager.accelerometerAvailable) 
[motionManager startAccelerometerUpdates]; 


if (motionManager.deviceMotionAvailable) 
[motionManager startDeviceMotionUpdates]; 


14.5.2 ”获取 感应 器 数据 


Core Motion 提供 了 两 套 访 问 感应 器 数据 的 机 制 。 其 中 一 套 机 制 能 够 定期 地 、 被 动 地 访问 运动 数据 ， 也 融 是 先 激活 感 应 器 (比方 说 ， 调 用 
startAccelerometerUpdates) ， 然 后 在 CMMotionManager 对 象 上 面 通过 对 应 的 属性 (例如 accelerometerData) 来 获取 数据 。 


如 果 轮 询 (polling) 方式 不 能 满足 需要 的 话 ， 可 以 使 用 基于 块 的 更 新 机 制 ， 也 束 是 提供 一 个 块 ， 每 当 感 应 器 有 变化 时 ， 系 统 就 会 执行 这 个 块 (比方 说 ， 调 用 
startAccelerometer-UpdatesToQueue: withHandler: ) 。 在 使 用 这 种 基于 处 理 程 序 的 方法 时 ,一定 要 给 感应 器 设置 更 新 间隔 (例如 
accelerometerUpdatelnterval) 。 这 个 间隔 是 有 最 大 值 和 最 小 值 限制 的 ， 如 果实 际 频率 对 应 用 程序 来 说 非常 重要 ， 需 要 在 系统 传 给 块 的 数据 对 象 里 面 检 查 时 间 截 :。 


14.6 解决 方案 : 通过 加 速度 来 判断 “上 “” 方 加 


iPhone 和 iPad 提 供 了 三 个 感应 器 ， 可 以 分 别 度量 设备 在 三 条 坐标 轴 上 的 加 速 诛 。 这 三 条 轴 是 相互 垂直 的 ，X 和 轴 表 示 左 右 方 向 、Y 轴 表示 上 下 方向 、Z 轴 表示 前 后 方 
向 。 三 个 感应 器 的 值 分 别 表 示 设 备 在 三 条 坐标 轴 上 由 于 重力 和 用 户 的 动作 而 受到 的 影响 。 我 们 可 以 把 iPhone 放 在 头 上 转圈 (向 心力 ) ， 或 是 将 其 从 高 楼 扼 下 〈 上 自由 沙 
体 ) ， 这 样 做 虽然 能 够 得 到 相当 强烈 的 力 反 馈 ， 但 是 却 会 把 iPhone 摔 成 碎片 ， 从 而 无 法 查 到 感应 器 的 数据 。 


知 想 监控 加 速 计 的 变化 ， 融 要 创建 Core Motion 的 管理 器 对 象 ， 然 后 设置 更 新 间隔 ， 启 动 管理 器 ， 并 传 入 作为 处 理 程序 的 块 ， 以 便 在 感应 器 友 生变 化 时 得 到 凋 
用 : 


motionManager - [[CMMotionManager alloc] init]; 
motionManager.accelerometerUpdateInterval - 0.005; 
if (motionManager.isAccelerometerAvailable) 


[motionManager startAccelerometerUpdatesToQueue: 
[NSOperationQueue mainQueue] 


withHandler:^(CMAccelerometerData *accelerometerData, 
NSError *error) { 


// handle the accelerometer update 


}]; 


使 用 Core Motion 框 架 的 时 候 ， 总 是 应 该 先 检查 相关 感应 器 是 否 可 用 。 开 始 监控 之 后 ， 处 理 程序 块 会 收 到 CMAccelerometerData 对 象 ， 开 发 者 可 以 追踪 并 响应 它 
们 。CMAccelerometerData 对 象 包含 CMAcceleration 结 构 体 ， 该 结构 体 由 x 轴 、y 轴 及 z 轴 上 的 浮 点 值 构 成 ， 每 个 浮 点 值 都 处 在 -1.0 到 1.0 的 范围 内 。 


解决 方案 14-3 使 用 这 些 值 来 判断 真实 的 “上 ”方向 。 它 会 根据 X 轴 和 Y 轴 上 面 的 加 速度 来 计算 反正 切 值 ， 以 求 出 箭头 图 案 当 前 的 “上 ”方向 与 真实 的 “上 ”方向 之 
间 的 夹 角 。 收 到 新 的 加 速度 消息 之 后 ， 这 条 解决 方案 会 旋转 UllmageView 实 例 ， 使 得 UllmageView 之 中 的 箭头 图 案 能 够 指向 真实 的 “上 方 ”， 如 图 14-1 所 示 。 由 于 程 


序 可 以 实时 响应 用 户 操 作 ， 所 以 无 论 用 户 如 何 调整 设备 的 方向 ， 箭 头 忌 是 会 对 准 真 实 的 “上 方 ”。 


#6000 Verizon >= 2:47 AM 


$ 100% i+ 


图 14-1 只 需 通过 反正 切 函 数 对 x 轴 和 y 轴 的 力 向 量 稍 作 数 学 运算 ， 就 可 以 找到 真实 的 “上 ”方向 。 在 本 例 中 ， 无 论 用 户 如 何 调整 设备 方向 ， 程 序 的 箭头 总 是 指向 真正 的 


Ew 
解决 方案 14-3 ”处 理 加 速度 事件 


- (void) loadView 

{ 
self.view = [[UIView alloc] init]; 
self.view.backgroundColor = [UIColor whiteColor] ; 
arrow = [[UIImageView alloc] 

initWithImage: [UIImage imageNamed:@"arrow") ] ; 

[self .view addSubview:arrow] ; 
PREPCONSTRAINTS (arrow) ; 
CENTER VIEW(self.view, arrow); 


motionManager = [[CMMotionManager alloc] init]; 
motionManager.accelerometerUpdateInterval = 0.005; 
if (motionManager.isAccelerometerAvailable) 
| 
[motionManager 
startAcceléerometerUpdatesToQueue: 
[NSOperationQueue mainQueue] 
withHandler: 
“(CMAccelerometerData *accelerometerData, 
NSError *error) | 
CMAcceleration acceleration - 
accelerometerData.acceleration; 


// Determine up from the x and y acceleration components 
float xx = -acceleration.x; 

float vy = acceleration.y; 

float angle = atan2(yy, Xxx]; 

[arrow setTransform: CGAffineTransformMakeRotation langle) | ; 


H; 


14.7 ”使 用 基本 的 万 同 值 


UIDevice 类 内 置 的 orientation 属 性 可 以 提供 设备 的 物理 方向 。 对 于 iOs 设 备 来 说 ， 该 属性 有 下 面 七 种 取 值 : 


- UIDeviceOrientationUnknown 一 一 当前 方向 未 知 。 


- UlDeviceOrientationPortrait home 按 钮 在 下 方 。 


- UlDeviceOrientationPortraitUpsideDown home 按 钮 在 上 方 。 


home 按 钮 在 右 侧 。 


- UlDeviceOrientationLandscapeLeft 


home 按 钮 在 左 侧 。 


: UlDeviceOrientationLandscapeRight 
- UIDeviceOrientationFaceUp 一 一 屏幕 面 朝 上 。 
- UIDeviceOrientationFaceDown 一 一 屏幕 面 朝 下 。 


设备 在 运行 应 用 程序 的 时 候 ， 其 方向 可 能 会 历经 上 述 七 种 取 值 中 的 几 种 ， 也 可 能 会 历经 全 部 七 种 取 值 。 昌 说 方向 值 是 与 加 速 计 相配 合 的 ， 但 它们 并 不 对 应 于 某 种 
特定 的 角度 值 。 

iOS 提 供 了 UlDeviceOrientationlsPortrait(0) 及 UlDeviceOrientationlsLandscape(0 这 两 个 内 置 的 宏 ， 可 以 根据 枚 举 值 来 判断 设备 是 否 处 于 竖 屏 或 横 屏 状态 。 我 们 
可 以 参照 下 面 这 段 代 码 对 UIDevice 做 扩展 ， 以 便 通 过 两 个 属性 来 给 出 设备 的 横竖 屏 状 态 : 


@property (nonatomic, readonly) BOOL isLandscape; 
Gproperty (nonatomic, readonly) BOOL isPortrait; 


- (BOOL) isLandscape 


| 


return UIDeviceOrientationIsLandscape(self.orientation) ; 


- (BOOL) isPortrait 


| 


return UIDeviceOrientationIsPortrait (self.orientation) ; 


开发 者 需要 用 beginGeneratingDeviceOrientationNotifications 来 启动 方向 变更 通知 ， 否 则 orientation 属 性 就 会 返回 0。 把 设备 的 方向 变更 通知 激活 之 后 ， 就 可 
以 用 代码 来 订阅 通知 了 。 我 们 可 以 添加 监听 器 (observer) ， 以 捕获 后 续 的 UIDevice-OrientationDidChangeNotification 事 件 。 调 用 
endGeneratingDeviceOrientation-Notification 方 法 则 可 以 取消 监控 。 


14.7.1 ”根据 加 速 计 来 判断 万 向 


程序 刚 启 动 的 时 候 ，UIDevice 类 并 不 会 报告 正确 的 方向 。 只 有 当 设 备 移动 到 新 的 位 置 ， 或 是 UIViewController 广 法 生效 之 后 ， 它 才 会 更 新 设备 的 方向 。 


必须 等 用 户 把 设备 从 标准 方向 移 开 ， 并 将 其 重新 恢复 到 标准 方向 之 后 ， 程 序 才能 意识 到 设备 正 处 在 竖 屏 状态 。 模 拟 器 和 iPhone 上 面 都 会 出 现 这 种 情况 ， 大 家 很 容 
吻 融 能 测试 出 来 。 (据说 有 人 在 苹果 公司 的 事务 管理 系统 里 面 报 告 过 这 个 问题 ， 但 是 苹果 公司 将 该 问题 天 闭 了 ， 因 为 它 认为 这 个 特性 本 来 束 应 该 设计 成 这 个 样子 。) 


为 了 解决 此 问题 ， 我 们 可 以 考虑 通过 Core Motion 框 架 来 获取 加 速 计 的 信息 ， 以 判断 角度 。 下 面 这 段 代 码 能 够 计算 出 设备 的 角度 : 


float xx = acceleration.x; 
float yy - -acceleration.y; 
device angle = M PI / 2.0£ - atan2(yy, xx); 


if (device angle » M PI) 
device angle -= 2 * M PI; 


计算 好 上 面 的 数值 之 后 ， 我 们 把 基于 加 速 计 的 角度 换算 成 设备 的 方向 。 下 面 是 换算 所 用 的 代码 : 


// Limited to the four portrait/landscape options 
- (UIDeviceOrientation)acceleratorBasedOrientation 


| 


CGFloat baseAngle = self.orientationAngle; 

if ((baseAngle » -M PI 4) && (baseAngle « M PI 4)) 
return UlDeviceOrientationPortrait; 

if ((baseAngle « -M PI 4) && (baseAngle » -3 * M PI 4)) 
return UlDeviceOrientationLandscapeLeft; 

if ((baseAngle » M PI 4) && (baseAngle « 3 * M PI 4)) 
return UIDeviceOrientationLandscapeRight ; 

return UlDeviceOrientationPortraitUpsideDown; 


请 注意 ， 这 段 范 例 代码 只 考虑 x-y 平 面 ， 因 为 与 用 户 界 面 有 关 的 大 部 分 测试 都 是 依照 这 个 平面 来 判定 的 。 这 上段 代码 完全 忽视 了 z 轴 ， 也 就 是 说 ， 对 于 设备 面 朝 上 和 
设备 面 朝 下 的 情况 来 说 ， 这 段 代 码 会 产生 随机 的 结果 。 若 是 真 需要 处 理 这 两 种 情况 ， 需 要 修改 范例 代码 ， 以 进行 更 为 详细 的 判断 。 


UlViewController 类 的 interfaceOrientation 实 例 方 法 用 于 报告 视图 控制 器 的 界面 方向 。 虽 说 这 并 不 能 取代 加 速 计 的 值 ， 但 是 很 多 界面 布局 操作 其 实 都 依赖 于 底层 
的 视图 方向 ， 而 不 是 设备 加 速 计 的 读数 。 


请 注意 ， 子 视图 控制 器 的 布局 方向 有 可 能 和 设备 的 方向 不 同 ， 在 iPad 上 面 尤 其 如 此 。 比 方 说 ， 在 横 屏 的 分 栏 视图 控制 器 里 ， 可 能 骨 有 来 用 竖 屏 布局 的 子 控制 器 。 
开发 者 需要 根据 底层 的 界面 方向 来 考虑 上 自己 所 写 的 方向 检测 代码 是 否 合 用 。 界 面 方向 也 许 比 设备 方向 更 为 可 靠 ， 尤 其 是 在 应 用 程序 刚 局 动 的 时 候 。 我 们 需要 根据 情况 
做 出 相应 处 理 。 


14.7.2 ”计算 相对 角度 


由 于 用 户 可 以 调整 屏幕 方向 ， 所 以 在 设备 屏幕 面 间 上 的 时 候 ， 我 们 必须 分 四 种 情况 来 给 出 界面 方向 与 设备 方向 之 间 的 夹 角 。 当 UIViewController 目 动 旋转 其 视图 
的 时 候 ， 开 友 者 需要 根据 旋转 后 的 界面 方向 ， 通 过 数学 运算 求 出 这 个 夹 角 。 


下 面 的 方法 是 为 UIDevice 的 category (扩展 ) 而 编写 的 ， 它 会 依照 设备 方向 算出 相对 角度 。 这 段 范例 代码 根据 GUI 目前 的 显示 方式 ， 计 算 设备 在 垂直 方向 上 的 偏 
移 角 : 


- (float) orientationAngleRelativeToOrientation: 


(UIDeviceOrientation)someOrientation 
float dOrientation = 0.0f; 


switch (someOrientation) 


| 


case UlIDeviceOrientationPortraitUpsideDown: 
{dOrientation = M PI; break;] 

case UIDeviceOrientationLandscapeLeft: 
{dOrientation = -(M PI/2.0f£); break;] 

case UIDeviceOrientationLandscapeRight : 
{dOrientation = (M PI/2.0f}; break; } 

default: break; 


float adjustedAngle = 

fmod(self.orientationAngle - dOrientation, 2.0f * M PI); 
if (adjustedAngle > (M PI + 0.01f)) 

adjustedAngle = (adjustedAngle - 2.0f * M PI); 
return adjustedAngle; 


上 述 方法 用 浮 点 数 模 除 (floating-point modulo) KitekReVLMARSAADAA IBA, ATRIA ER SERRE iA. 


Qez 从 iOS 6 开始 ， 我 们 就 应 该 在 根 视图 控制 器 和 Info.plist 文 件 中 使 用 supported-InterfaceOtrientations 来 规定 界面 方向 ， 而 不 应 该 再 使 用 shouldAutor- 
otateToInterfaceOrientation: 了 。iOS 会 采用 这 两 处 supported-InterfaceOrientations 值 的 交集 来 决定 应 用 程序 中 可 以 出 现 的 界面 方向 。 


14.8 解决 方案 : 使 用 加 速 计 来 移动 屏 春 上 的 物体 


只 需 编写 少许 代码 ， 即 可 利用 iPhone 的 加 速 计 来 “移动 ”屏幕 上 的 物体 ， 以 便 在 用 户 倾 斜 手机 的 时 候 做 出 实时 响应 。 解 决 方案 14-4 构 建 了 一 只 市 有 动画 效果 的 晴 
蝶 ， 它 可 以 随 着 用 户 的 操作 在 屏幕 上 飞 来 飞 去 。 


实现 该 功能 的 关键 在 于 添加 “物理 计时 器 ” (physics timer) 。 我 们 不 像 解决 方案 14-3 那 样 直接 响应 加 速度 的 变化 ， 而 是 令 加 速度 处 理 程序 去 衡量 当前 的 力度 。 
计时 器 例 程 会 修改 蝴蝶 的 frame， 以 便 把 力 的 效果 运用 在 它 身 上 。 下 面 列 出 实现 该 功能 时 的 几 个 要 点 : 


只 要 力 的 方向 不 变 ， 蝴 蝶 就 会 持续 加 速 。 它 的 速度 会 一 直 增 大 ， 并 且 会 根据 加 速 力 (acceleration force) 在 x 轴 或 y 轴 的 程度 来 相应 地 缩放 。 
计时 器 会 调用 tick 例 程 ， 该 例 程 会 把 速度 向 量 登 加 到 蝴蝶 的 原点 上 面 。 


蝴蝶 的 移动 范围 是 有 限制 的 。 碰 到 边缘 之 后 ， 就 不 能 继续 朝 着 那个 方向 移动 了 。 这 样 可 以 令 蝴 蝶 始 终 出 现在 屏幕 上 。tick 方 法 会 检测 蝴蝶 是 否 碰 到 了 某 边 界 。 比 
方 说 ， 蝴 蝶 碰 到 了 垂直 边界 之 后 ， 依 然 可 以 在 上 下 方向 上 移动 。 


- 蝴蝶 会 调整 自己 的 方向 ， 使 它 看 起 来 总 是 朝 “ 下 ”。 我 们 在 tick 方 法 中 对 其 进行 简单 的 旋转 变换 。 在 对 ftame 或 中 心 点 做 偏 移 之 后 ， 如 果 还 要 执行 变换 ， 就 要 小 心 
。 此 时 总 是 应 该 先 重 置 变换 和 矩阵， 然后 运用 偏 移 量 ， 最 后 再 执行 旋转 变换 。 如 果 不 这 么 做 ， 就 会 导致 fame 出 现 不 符合 预期 的 缩放 或 斜 切 效 果 。 


动作 管理 器 的 配置 与 清理 


解决 方案 14-4 的 establishMotionManager 及 shutDownMotionManager 方 法 可 以 按照 需要 来 启用 或 关闭 程序 中 的 动作 管理 器 (motion manager) 。 应 用 程序 


激活 或 暂停 的 时 人 息 ， 系 统 会 从 应 用 程序 委托 里 面 调 用 这 两 个 方法 : 


- (void)applicationWillResignActive: (UIApplication *)application 


| 


[tbvc shutDownMotionManager] ; 


- (void) applicationDidBecomeActive: (UIApplication *) application 


| 


[tbvc establishMotionManager]; 


这 两 个 方法 提供 了 一 种 优雅 的 方式 ， 使 得 开 友 者 可 以 根据 应 用 程序 的 当前 状态 来 关闭 或 开局 动作 服务 。 


Qux “计时 器 未 身 并 不 使 用 基于 块 的 API。 如 果 你 喜欢 把 计时 器 同 决 结合 起 来 ， 而 不 喜欢 用 回调 来 处 理事 件 ， 需 要 在 GitHub 上 面 搜索 一 套 可 以 实现 此 功能 的 代 
码 。 


解决 方案 14-4 ”根据 加 速 计 所 反馈 的 数据 来 滑动 屏幕 上 的 物体 
@implementation TestBedViewController 


- (void)tick 


| 


butterfly.transform - CGAffineTransformIdentity; 


// Move the butterfly according to the current velocity vector 

CGRect rect - CGRectOffset(butterfly.frame, xVelocity, 0.0f); 

if (CGRectContainsRect(self.view.bounds, rect)) 
butterfly.frame - rect; 


rect - CGRectOffset(butterfly.frame, 0.0f, yVelocity); 
if (CGRectContainsRect(self.view.bounds, rect)) 
butterfly.frame - rect; 


butterfly.transform - 
CGAffineTransformMakeRotation(mostRecentAngle - M PI 2); 


(void)shutDownMotionManager 
NSLog(e"Shutting down motion manager"); 
[motionManager stopAccelerometerUpdates]; 
motionManager - nil; 

[timer invalidate]; 
timer s nil; 


(void)establishMotionManager 


if (motionManager) 
[self shutDownMotionManager]; 


NSLog(G"Establishing motion manager"); 


// Establish the motion manager 


motionManager - [[CMMotionManager alloc] init]; 
if (motionManager.accelerometerAvailable) 
[motionManager 


startAccelerometerUpdatesToQueue: 

[ [NSOperationQueue alloc] init] 
withHandler:^(CMAccelerometerData *data, NSError *error) 
{ 

// Extract the acceleration components 
float xx = -data.acceleration.x; 
float yy = data.acceleration.y; 
mostRecentAngle = atan2(yy, xx); 


// Has the direction changed? 

float accelDirx = SIGN(xVelocity) * -1.01; 
float newDirX = SIGN (XX); 

float accelDirY = SIGN(yVelocity) * -1.0f; 
float newDirY = SIGN(yy) ; 


// Accelerate. To increase viscosity, 
// lower the additive value 


if (accelDirX == newDirX) 

xAccel = (abs(xAccel) + 0.85f) * SIGN(xAccel); 
if (accelDirY -- newDirY) 

yAccel = (abs(yAccel) + 0.85f) * SIGN(yAccel) ; 


// Apply acceleration changes to the current velocity 
xVelocity = -xAccel * xx; 
yVelocity = -yAccel * yy; 


yl; 


// Start the physics timer 
timer = [NSTimer scheduledTimerWithTimeInterval: 0.03f 
target:self selector:@selector (tick) 


userInfo:nil repeats:YES]; 


- (void)initButterfly 


| 


CGSize size; 


// Load the animation cells 
NSMutableArray *butterflies - [NSMutableArray array]; 
for (int i = Ly X <= 17j 1t) 


{ 


NSString *fileName = 

[NSString stringWithFormat:@"bf $d.png", i]; 
UIImage *image - [UIImage imageNamed:fileName]; 
Size - image.size; 
[butterflies addObject:image] ; 


// Begin the animation 

butterfly = [[UIImageView alloc] 
initWithFrame: (CGRect) {.size=size}]; 

[butterfly setAnimationImages:butterflies] ; 

butterfly.animationDuration = 0.75f; 


[butterfly startAnimating] ; 


// Set the butterfly's initial speed and acceleration 
xAccel = 2.0£; 

yAccel z 2.0f; 

xVelocity = 0.0f; 

yVvelocity = 0.0f; 


// Add the butterfly 
(self.view addSubview:butterfly]; 


- (void)viewDidAppear: (BOOL)animated 


[super viewDidAppear:animated]; 


// Get our butterfly centered 
butterfly.center - RECTCENTER(self.view.bounds); 


- (void) loadView 


self.view = [[UIView alloc] init]; 
self.view.backgroundColor = [UIColor whiteColor] ; 


[self initButterfly] ; 


14.9 解决 万 案 : 基于 加 速 计 的 滩 动 视 


很 多 读者 都 希望 本 书 能 在 这 一 版 中 添加 有 关 “倾斜 滚动 功能 ” (tilt scroller) 的 解决 方案 。 此 功能 会 根据 设备 内 置 的 加 速 计 来 移动 UlscrollView 中 的 内 容 。 用 户 调 
整 设备 的 时 候 ， 其 中 的 内 容 会 相应 地 向 下 滚动 。 我 们 并 不 是 把 视图 直接 放 在 屏幕 上 ， 而 是 要 把 UlScrollView 中 的 内 容 滚动 到 新 的 位 置 。 


创建 这 种 界面 的 难点 在 于 : 如 何 规 定 坐 标 轴 的 基准 角度 ， 使 得 设备 处 在 该 角度 的 时 候 ， 其 中 的 内 容 不 会 滚动 。 很 多 人 都 党 得 应 该 把 设备 平 身 于 泉 面 时 的 角度 设 为 
基 佳 角度， 此 时 设备 的 z 轴 是 垂直 向 上 的 。 其 实 这 是 个 很 糟糕 的 设计 。 如 果 使 用 这 个 角度 作为 基准 角度 ， 那 么 用 户 在 浏览 内 容 的 时 候 ， 必 须 把 设备 向 下 倾斜 或 向 上 倾斜 
才 行 。 但 是 设备 倾斜 过后 ， 用 户 融 无 法 完全 看 到 屏幕 里 的 内 容 了 ， 当 用 户 坐 下 来 使 用 手机 ， 或 是 手机 位 于 用 户头 项 的 时 候 ， 这 个 问题 尤为 突出 。 


于 是 ， 解 决 方案 14-5 规 定 : 当 z 轴 指向 大 约 45 度 角 的 方向 时 ， 设 备 中 的 内 容 不 会 滚动 ， 这 个 角度 正 是 用 户 手 持 iPhone 或 iPad 时 的 角度 。 它 处 于 “设备 面 朝 


上 ”和 “设备 面 朝 用 户 ” 这 两 个 位 置 之 间 。 解 决 方案 14-5 根 据 这 一 角度 来 执行 相应 的 运算 。 用 户 从 这 个 45 度 角 的 位 置 向 下 或 向 上 倾斜 手机 时 ， 都 


幕 中 的 内 容 。 


解决 方案 14-5 ”为 UlScrollView 添 加 倾斜 滚动 功能 


- (void)tick 

| 
xOff += xVelocity; 
xOff = MIN(xOff, 1.0f); 
xOff = MAX(xOff, 0.0f); 


yOff += yVelocity; 
yOff = MIN(yOff, 1.0f); 
yOff = MAX(yOff, 0.0f); 


// update the content offset based on the current velocities 
UIScrollView *sv - (UIScrollView *) self.view; 
CGFloat xSize - sv.contentSize.width - sv.frame.size.width; 


CGFloat ySize - sv.contentSize.height - sv.frame.size.height; 


sv.contentOffset - CGPointMake(xOff * xSize, yOff * ySize); 


- (void) viewDidAppear: (BOOL)animated 
| 
[super viewDidAppear:animated]; 
NSString *map = @"http://maps.weather.com/images/\ 
maps/current/curwx 720x486.jpg"; 
NSOperationQueue *queue - [[NSOperationQueue alloc] init]; 
[queue addOperationWithBlock: 
É 
// Load the weather data 
NSURL *weatherURL - [NSURL URLWithString:map]; 


ab 
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最 大 限度 地 看 到 屏 


NSData *imageData - [NSData dataWithContentsOfURL:weatherURL]; 


// Update the image on the main thread using the main queue 
[[NSOperationQueue mainQueue] addOperationWithBlock:^( 
UIImage *weatherImage - [UIImage imageWithData:imageData]; 
UIImageView *imageView - 
[[UIImageView alloc] initWithImage:weatherImage]; 
CGSize initSize - weatherImage.size; 
CGSize destSize - weatherImage.size; 


// Ensure that the content size is significantly bigger 

// than the screen can show at once 

while ((destSize.width « (self.view.frame.size.width * 4)) || 
(destSize.height « (self.view.frame.size.height * 4))) 


destSize.width += initSize.width; 
destSize.height += initSize.height; 


imageView.frame = (CGRect){.size = destSize}; 
UIScrollView *sv = (UIScrollView *) self.view; 
sv.contentSize = destSize; 


[sv addSubview: imageView] ; 


// only allowing accelerometer-based scrolling 
scrollView.userInteractionEnabled = NO; 


// Activate the accelerometer 
[motionManager startAccelerometerUpdatesToQueue: 
[NSOperationQueue mainQueue] withHandler: 
^(CMAccelerometerData *accelerometerData, 


NSError *error) { 


// extract the acceleration components 

CMAcceleration acceleration - 
accelerometerData.acceleration; 

float xx = -acceleration.x; 

// between face-up and face-forward 

float yy = (acceleration.z + 0.5f) * 2.0€£; 


// Has the direction changed? 

float accelDirX - SIGN(xVelocity) * -1.0f; 
float newDirX = SIGN(xx); 

float accelDirY - SIGN(yVelocity) * -1.0f; 
float newDirY - SIGN(yy); 


// Accelerate. To increase viscosity lower the additive value 
if (accelDirX == newDirxX) 
xAccel = (abs(xAccel) + 0.005f) * SIGN(xAccel) ; 


if (accelDirY -- newDirY) 
yAccel = (abs(yAccel) + 0.005f) * SIGN(yAccel); 
// Apply acceleration changes to the current velocity 
xVelocity = -xAccel * xx; 
yVelocity = -yAccel * yy; 


}]; 


// Start the physics timer 
[NSTimer scheduledTimerWithTimeInterval:0.03f 
target:self selector:@selector (tick) 


userInfo:nil repeats: YES] ; 


与 解决 方案 14-4 相 比 ， 本 例 还 有 个 变化 ， 那 就 是 把 加 速度 常量 设置 得 更 慢 了 。 由 于 屏幕 上 的 内 容 滚动 得 比较 慢 ， 所 以 用 户 更 加 容易 控制 滚动 速度 。 


14.10 ”解决 方案 : 获取 并 使 用 设备 的 姿态 


假设 桌子 上 有 一 人 台 iPad。iPad 里 面 显示 了 一 幅 图 像 ， 用 户 可 以 俯 身 坦 看 这 幅 图 。 如 果 iPad 人 在 不 离开 提 子 的 前 提 下 原 地 旋转 ， 那 么 当 iPad 转 动 时 ， 该 图 片 始终 会 处 
于 固定 的 位 置 ， 继 续 与 它 周 边 的 空间 相对 齐 ， 而 不 会 受到 iPad 的 影响 。 无 论 如 何 旋转 jPad， 这 幅 图 都 不 会 随 设 备 “ 移 动 ”， 因 为 它 会 根据 设备 的 物理 运动 来 平衡 自身 
的 位 置 。 这 残 是 解决 方案 14-6 的 工作 原理 ， 它 利用 设备 中 的 了 螺 仪 来 实现 此 功能 。 这 条 解决 方案 必须 使 用 陀螺 仪 才能 运作 。 


图 像 会 根据 用 户 握 持 设备 的 方式 而 做 出 调整 。 除 了 把 iPad 放 在 桌面 上 旋转 之 外 ， 我 们 也 可 以 把 设备 拿 起 来 ， 令 其 朝 着 空间 中 的 某 个 方位 。 如 果 将 设备 面 朝 下 并 置 
于 头 项 ， 那 么 用 户 就 能 拾 头 看 到 图 像 的 “反面 ”了 。 人 在 操控 设备 的 过 程 中 ， 图 像 会 做 出 相应 的 调整 ， 以 便 在 iPad 里 面 创建 一 个 虚拟 的 静态 空间 。 


解决 方案 14-6 演 示 了 如 何 通 过 几 次 简单 的 几何 变换 来 实现 此 功能 。 它 会 建立 动作 管理 器 、 订 阅 与 设备 动作 有 关 的 通知 ， 然 后 根据 动作 管理 器 所 返回 的 roll、 
pitch、yaw 角 度 来 变换 图 像 。 


解决 方案 14-6 ”通过 设备 的 动作 信息 把 图 像 国 定 在 空间 中 的 某 个 位 置 上 
- (void) shutDownMotionManager 


NSLog(e"Shutting down motion manager"); 
[motionManager stopDeviceMotionUpdates]; 
motionManager - nil; 


- (void)establishMotionManager 


( 


if (motionManager) 


[self shutDownMotionManager]; 
NSLog(G"Establishing motion manager"); 


// Establish the motion manager 
motionManager - [[CMMotionManager alloc] init]; 
if (motionManager.deviceMotionAvailable) 
[motionManager 
startDeviceMotionUpdatesToQueue: 
[NSOperationQueue currentQueue] 
withHandler: ^(CMDeviceMotion *motion, NSError *error) { 
CATransform3D transform; 
transform - CATransform3DMakeRotation( 
motion.attitude.pitch, 1, 0, 0); 
transform - CATransform3DRotate (transform, 
motion.attitude.roll, 0, 1, 0); 
transform = CATransform3DRotate (transform, 
motion.attitude.yaw, 0, 0, 1); 
imageView.layer.transform = transform; 


}]; 


14.11 用 Motion Event 来 检测 晃动 


iPhone 如 果 侦 测 到 晃动 等 动作 事件 ， 就 会 把 该 事件 传 给 目前 的 第 一 响应 者 ， 也 就 是 传 给 响应 者 链 中 的 主 对 象 。 所 谓 响应 者 (responder) ， 就 是 一 种 能 够 处 理事 
件 的 对 象 。 所 有 的 视图 与 视窗 都 是 啊 应 者 ， 而 应 用 程序 对 象 也 是 一 种 响应 者 。 


响应 者 链 是 一 套 对 象 体系 ， 其 中 的 所 有 对 象 都 可 以 对 事件 做 出 响应 。 位 于 响应 者 链 开头 的 对 象 如 果 能 够 处 理 某 事件 ， 那 么 该 事件 融 不 再 继续 向 下 传递 了 。 知 是 不 
能 处 理 ， 那 么 该 事件 将 会 移动 到 下 一 个 响应 者 。 


任何 对 象 都 可 以 通过 becomeFirstResponder 来 宣称 自己 是 第 一 响应 者 ， 并 获得 这 种 身份 。 在 下 面 这 段 代 码 中 ， 当 UIViewController 把 视图 显示 到 屏幕 上 的 时 
候 ， 它 会 变 成 第 一 响应 者 ， 而 当 视 图 消失 时 ， 它 又 会 放弃 第 一 响应 者 的 身份 : 


- (BOOL)canBecomeFirstResponder { 
return YES; 


// Become first responder whenever the view appears 
- (void)viewDidAppear: (BOOL)animated { 


[super viewDidAppear:animated]; 
[self becomeFirstResponder]; 


// Resign first responder whenever the view disappears 
- (void)viewWillDisappear: (BOOL)animated { 


[super viewWillDisappear:animated]; 
[self resignFirstResponder]; 


第 一 响应 者 会 收 到 所 有 的 触摸 事件 及 动作 事件 。 与 动作 有 关 的 回调 ， 分 别 对 应 于 UIView 里 面 的 各 种 触摸 回调 。 这 些 回调 方法 是 : 


- motionBegan: withEvent: 一 一 这 个 回调 方法 会 在 动作 事件 刚 开 始 的 时 候 执行 。 笔 者 编写 本 书 时 ， 系 统 只 能 识别 一 种 动作 事件 ， 即 晃动 (shake) o 以 后 也 许 
还 能 识别 其 他 类 型 的 动作 ， 所 以 我 们 应 该 用 代码 来 判断 动作 类 型 。 


- motionEnded: withEvent: 一 -一 动作 事件 结束 时 ， 第 一 响应 者 会 收 到 这 个 回调 。 


: motionCancelled: withEvent: 一 一 与 触摸 事件 一 样 ， 动 作 事件 也 会 由 于 打 进 来 的 电话 或 其 他 系统 事件 而 取消 。 革 果 公 司 建议 开发 者 在 编写 实际 的 代码 时 ， 应 
该 把 与 动作 事件 有 关 的 三 个 回调 方法 全 都 实现 好 ( 同 理 ， 也 应 该 把 与 触摸 事件 有 关 的 四 个 回调 方法 全 都 实现 好 ) 。 


下 面 这 段 范 例 代 码 实 现 了 与 动作 事件 有 天 的 两 个 回调 方法 : 


- (void)motionBegan: (UIEventSubtype)motion 


withEvent: (UIEvent *)event { 


// Play a sound whenever a shake motion starts 
if (motion != UIEventSubtypeMotionShake) return; 
[self playSound:startSound]; 


- (void)motionEnded: (UIEventSubtype)motion withEvent: (UIEvent *)event 


// Play a sound whenever a shake motion ends 
if (motion !- UIEventSubtypeMotionShake) return; 
[self playSound:endSound]; 


如 果 要 在 设备 上 测试 这 段 代 码 ， 请 注意 几 件 事 。 首 先 ， 从 用 己 的 角度 来 看 ， 事 件 的 开始 和 结束 几乎 在 同一 时 间 友 生 。 所 以 ， 给 这 两 种 情况 都 播放 一 饥 声 音 ， 显 得 
有 氮 重复 。 第 二 ， 设 备 更 容易 检测 出 左右 方向 的 晃动 。iPhone 检 测 左右 方向 的 晃动， 要 比 检测 前 后 方向 及 上 下 方向 的 晃动 更 为 灵敏 。 第 三 ， 芋 果 公 司 在 实现 动作 事件 
时 采用 了 轻微 的 间隔 机 制 。 也 融 是 说 ， 在 前 一 个 事件 处 理 完 之 后 的 一 两 秒 内 ， 不 会 再 产生 新 的 动作 事件 。 晃 动 切换 和 网 动 撤销 事件 都 有 这 种 延迟 。 


14.12 EAIN 


有 很 多 种 使 用 外 接 屏 幕 的 办 法 。 以 最 新 的 iPad 为 例 。 第 2 代 、 第 3 代 、 第 4fSiPad 都 提供 了 内 置 的 屏幕 镜像 功能 。 通 过 VGA 或 HDMI 线 ， 我 们 可 以 把 内 容 同 时 显示 在 
外 接 屏 幕 与 内 置 屏幕 上 面 。 某 些 设 备 还 可 以 用 AirPlay 把 屏幕 内 容 以 无 线 方 式 分 享 到 苹果 公司 TV 上 面 ，AirPlay 是 苹果 公司 的 一 项 专利 ， 它 能 够 无 线 地 传播 视频 。 这 些 镜 
像 分 享 功能 非 党 方 便 ， 而 且 我 们 并 不 局 限于 把 一 个 iOs 屏 幕 里 的 内 容 简单 地 复制 到 另 一 个 屏幕 中 。 


UlDevice 类 可 以 检测 外 接 屏幕 ， 并 向 其 中 分 别 写 入 内 容 。 开 发 者 可 以 把 接 入 的 任何 显示 器 都 当成 新 的 窗口 ， 并 在 其 中 创建 与 设备 主 显 示 器 上 的 视图 不 同 的 内 容 。 
凡是 通过 线 费 接 入 的 屏幕 ， 都 能 够 这 样 做 ， 在 ijPad 2 及 后 续 机 型 、iPhone 4S 及 后 续 机 型 、iPod touch 第 五 代 及 后 续 机 型 上 面 ， 还 可 以 通过 AirPlay 技 术 以 无 线 方式 把 
内 容 传 播 到 Apple TV 2 及 其 后 续 机 型 的 屏幕 中 。 有 个 第 三 方程 序 叫 作 Reflector， 它 可 以 通过 AirPlay 把 内 容 显 示 到 Mac 或 Windows 电 脑 上 。 


屏幕 的 几何 特征 [是 非常 重要 的 。iOS 设 备 目前 的 屏幕 分 辨 率 有 如 下 几 种 : 老式 iPhone 是 320 像 素 x480 像 素 、 带 有 Retina 屏 幕 的 iPhone 是 640 像 素 x960 像 素 、 
iPad 是 1024 像 素 x768 像 素 、 市 有 Retina 屏 幕 的 ijPad 是 2048 像 素 x1536 像 素 。 而 一 般 的 复合 输出 /分 量 输出 所 采用 的 分 辨 率 是 720 像 素 x480 像 素 (480i 及 
480p) ，VGA 输 出 则 是 1024 像 素 x768 像 素 及 1280 像 素 x720 像 素 (720p) ， 另 外 ， 也 有 质量 更 高 的 HDMI 输 出 。 除 了 这 些 问题 之 外 ， 还 有 “过 扫 


Hi” (overscan) [以 及 “目标 设备 的 限制 ”等 因素 ， 这 使 得 Video Out (视频 输出 ) 的 分 辨 率 变 得 复杂 起 来 。 

所 幸 苹果 公司 提供 了 一 些 方便 而 实用 的 适 配 技 术 ， 可 以 化 解 这 一 难题 。 我 们 不 需要 在 外 接 屏幕 与 设备 内 置 的 屏幕 之 间 创 建 一 一 对 应 关系 ， 而 是 可 以 直接 根据 外 接 
设备 的 属性 来 构建 内 容 。 我 们 只 需 创建 视窗 ， 向 其 中 填充 内 容 ， 然 后 把 视窗 显示 出 来 即 可 。 

如 果 想 开发 Video Out 程 序 ， 就 不 要 假定 用 户 一 定 会 使 用 AirPlay。 很 多 用 户 依然 会 通过 老式 的 线 缆 接 入 方式 来 连接 显示 器 或 投影 仪 。 所 以 ， 每 种 类 型 的 线 绕 至 少 


要 准备 一 条 (复合 输出 线 、 分 量 输出 线 、VGA 线 、HDMI 线 ) ， 而 且 还 要 分 别 准备 一 台 支 持 AirPlay 的 iPhone 及 iPad， 只 有 这 样 ， 才 能 完整 地 测试 每 一 种 输出 方式 。 第 
SARA (也 就 是 没有 打上 Made for iPhone/iPad 标 贴 的 线 绕 ) 是 无 法 支持 Video Out 的 ,一 定 要 购买 苹果 公司 认可 的 线 绕 。 


[1] 这 里 是 按照 原文 geometty 对 译 ， 实 际 上 可 以 根据 语 境 理解 为 “分 辨 率 ” 等 含义 。 
[2] 这 个 术语 的 大 意 是 : 显示 器 会 把 将 要 显示 的 图 像 略微 放大 ， 从 而 导致 用 户 能 够 看 到 的 图 像 范围 略 小 于 图 像 的 真实 尺寸 。 译 者 注 


14.12.1 TEES 


UlScreen 类 可 以 查 出 设备 所 连接 的 屏幕 数量 : 


#define SCREEN CONNECTED ([UIScreen screens] .count > 1) 


如 果 [UlScreen screens]RZX EAT 1, MERRIA TIRARA. screens Á ANTR, BERBER. 


每 个 屏幕 都 有 自己 的 bounds 及 scale， 前 者 表示 以 点 为 单位 的 物理 尺寸 ， 后 者 表示 点 与 像素 之 间 的 换算 关系 。 通 过 下 面 两 个 标准 的 通知 ， 开 发 者 可 以 获知 设备 何 时 
连 上 了 外 接 屏幕 ， 以 及 何 时 与 外 接 屏幕 断 开 : 


// Register for connect/disconnect notifications 
[[NSNotificationCenter defaultCenter] 


addObserver:self selector:Gselector(screenDidConnect:) 


name:UIScreenDidConnectNotification object:nil]; 
[[NSNotificationCenter defaultCenter] 
addObserver:self selector:@selector(screenDidDisconnect: ) 


name :UIScreenDidDisconnectNotification object:nill; 


与 设备 相连 的 屏幕 ， 有 可 过 绪 纺 连接 的 ， 也 有 可 能 是 通过 AirPlay 无 绪 连 接 的 。 接 到 上 述 通 知之 后 ， 我 们 应 该 查 询 屏 幕 数量 ， 并 根据 新 的 屏幕 个 数 来 调整 用 
PRHE. 


开 友 者 应 该 在 设备 接 入 新 屏幕 的 时 候 设置 好 视窗 ， 并 且 企 设备 与 屏幕 断 开 时 释放 视窗 。 每 个 屏幕 都 应 该 有 目 己 的 视窗 ， 以 便 管 理 该 屏幕 中 的 内 容 。 设 备 与 屏幕 断 
开 连 接 之 后 ， 融 不 要 再 持 有 那个 视窗 了 ， 而 是 应 该 将 其 释放 ， 等 下 次 接 入 屏幕 的 时 候 再 去 重建 。 


Gis 通过 镜像 方式 接 入 的 屏幕 是 不 计 入 scfeens 数 组 的 。 镜 像 保 存在 主屏 幕 的 mittoredScreen 属 性 中 。 如 果 设 备 禁 用 镜像 功能 、 尚 未 连接 镜像 屏幕 ， 或 是 不 支持 
镜像 ， 那 么 该 属性 就 是 hil。 


如 果 创 建 了 新 的 屏幕 对 象 ， 并 用 它 来 向 外 接 屏幕 里 写 入 内 容 ， 就 会 履 盖 现 有 的 镜像 功能 。 只 要 程序 开始 向 外 接 屏幕 里 写 入 内 容 ， 它 就 会 优先 于 镜像 ， 即 便 用 户 局 
用 了 镜像 也 是 如 此 。 


14.12.2 Sa 


每 个 屏幕 都 提供 了 availableModes 属 性 。 该 属性 是 个 由 UlScreenMode 对 象 所 构成 的 数组 ， 其 中 的 对 象 按 照 分 辩 率 从 低 到 高 排列 。 每 个 UIScreenMode 都 有 size 
属性 ， 用 来 表示 目标 屏幕 所 支持 的 某 种 分 辩 率 。 很 多 屏幕 都 支持 多 种 分 辩 率 模式 。 比 方 说 ，VGA 显 示 器 可 能 会 提供 多 达 六 种 或 六 种 以 上 的 分 辩 率 模式 。 支 持 的 模式 数 
量 由 硬件 决定 。 显 示 器 至 少 能 够 支持 一 种 分 辩 率 模式 ， 如 果 能 够 支持 多 种 模式 ， 那 么 应 该 向 用 户 提供 选项 。 


14.12.3 ”配置 视频 输出 
从 [UIScreens screens] 数 组 获取 到 表示 外 接 屏幕 的 对 象 之 后 ， 应 该 查询 可 供 使 用 的 分 辩 率 模式 ， 并 从 中 选择 一 种 。 一 般 来 说 ， 列 表 中 的 最 后 一 种 模式 总 是 分 辩 率 
最 高 的 模式 ， 而 列表 中 的 首 个 模式 ， 则 是 分 辩 率 最 低 的 模式 。 


右 想 局 动 Video Out 流 ， 则 需 新 建 UIWindow， 并 按照 选 定 的 分 辨 率 模式 来 设置 其 大 小 。 然 后 给 视窗 添加 视图 ， 用 以 绘制 内 容 。 接 下 来 ， 把 外 部 屏幕 同 视 窗 相关 
联 ， 并 调用 视窗 的 makeKkeyAndVisible 方 法 。 访 方法 令 视窗 能 够 显示 在 外 接 屏幕 上 面 ， 并 且 使 开 友 者 可 以 使 用 该 视窗 。 最 后 ， 重 新 在 原来 的 视窗 上 面 调 用 


makekeyAndVisible 方 法 。 这 使 得 用 户 可 以 继续 操作 主屏 幕 。 不 要 忽略 最 后 这 一 步 。 人 否则 ， 用 户 会 上 友 现 设备 无 法 响应 触摸 。 下 面 这 段 代 码 实 现 了 必要 的 步骤 ， 从 而 把 
外 接 屏 幕 设 置 好 : 
self.outputWindow = [[UIWindow alloc] initWithFrame:theFrame]; 


outputWindow.screen - secondaryScreen; 
[outputWindow makeKeyAndVisible] ; 
[delegate.view.window makeKeyAndVisible] ; 


14.124 添加 CADisplayLink 
CADisplayLink 是 一 种 计时 器 ， 可 以 将 绘制 操作 与 显示 器 的 刷新 率 相 同步 。 开 发 者 可 以 修改 CADisplayLink 的 framelnterval 属 性 ， 以 调整 每 次 刷新 时 必须 经 过 的 帧 


数 。 它 的 默认 值 是 1。 值 越 大 ， 刷 新 率 越 低 。 将 它 设置 成 2， 可 以 令 刷新 率 减 半 。 开 发 者 应 该 在 显示 器 与 设备 相连 的 时 候 创建 CADisplayLink。UlScreen 类 中 有 个 方 
法 ， 可 以 返回 与 该 屏幕 相对 应 的 CADisplayLink 对 象 。 该 方法 需要 指定 待 调用 的 目标 和 选择 子 。 


CADisplayLink 会 定期 触 友 其 目标 ， 使 得 开发 者 知道 何 时 应 该 更 新 Video Out 屏 幕 。 如 果 想 把 CPU 负 载 降 下 来 ， 束 可 以 调 高 间隔 值 ， 但 这 样 做 会 令 帧 速率 下 降 。 在 
刷新 率 与 CPU 负载 之 间 权 衡 ， 是 一 件 很 重要 的 事 ， 直 接 操 纵 界 面 对 设 备 CPU 的 响应 能 力 要 求 很 高 ， 设 计 这 种 程序 时 ， 更 应 注意 此 问题 。 


解决 方案 14-7 中 的 代码 ， 依 照 冲 规 方式 来 使 用 运行 循环 ， 这 样 做 延迟 最 小 。 每 次 用 完 CADisplayLink 之 后 ， 融 立刻 令 其 失效 ， 然 后 把 它 从 运行 循环 里 面 移 除 。 


14.12.5 XPH TMZ 


开发 者 可 以 为 UIScreen 类 的 overscanCompensation 属 性 设置 某 种 值 ， 以 指定 显示 器 应 该 如 何 补偿 因 处 于 屏幕 边缘 而 损失 掉 的 像素 。 该 属性 的 取 值 请 参阅 苹果 公 
司 的 文档 ， 它 的 大 概 意思 是 说 : 显示 器 是 应 该 裁 切 程序 的 内 容 ， 还 是 应 该 缩小 程序 的 内 容 并 给 屏幕 边缘 填 上 黑 边 。 


14.12.6 VIDEOKIt 


解决 方案 14-7 创 建 了 名 为 VIDEOKit 的 客 尸 端 ， 用 来 演示 外 接 屏幕 的 基本 用 法 。 它 会 演示 使 用 有 线 或 无 线 外 接 屏幕 时 所 需 的 每 个 步 又。 我 们 调用 
startupWithDelegate: 来 对 外 接 屏 幕 进行 监控 ， 并 把 负责 为 外 接 屏 幕 创建 内 容 的 主 视图 控制 器 传 给 该 方法 。 


VIDEOKit 内 部 的 init 方 法 会 监听 屏幕 的 连接 和 断 开 事件 ， 并 按照 需要 来 构建 或 释放 视窗 。 当 CADisplayLink 对 和 象 触 皮 回调 的 时 候 ， 它 会 执行 名 为 
updateExternalView: 的 非 正 式 委 托 方法 。 而 在 执行 该 方法 时 ， 它 会 传 入 一 个 视图 ， 此 视图 位 于 外 部 显示 器 的 视窗 之 中 ， 委 托 方 法 可 以 在 这 个 视图 上 面 绘制 内 容 。 


本 条 解决 方案 的 范例 代码 会 把 某 种 颜色 值 保存 到 视图 控制 器 的 实例 变量 中 ， 然 后 在 控制 器 所 实现 的 委托 方法 里 面 以 这 种 颜色 来 泻 染 外 部 显示 器 : 


- (void)updateExternalView: (UIImageView *)aView 


| 


aView.backgroundColor = color; 


- (void)action:(id)sender 


| 


color = [UIColor randomColorl; 


用 尸 点 击 按钮 时 ， 视 图 控制 器 会 生成 一 种 新 颜色 。 而 当 VIDEOkKit 请 求 视 图 控制 器 去 更 新 外 部 视图 的 时 人 息 ， 控 制 器 会 把 这 种 颜色 设置 成 视图 的 背景 色 。 于 是 ， 外 部 
显示 器 的 屏幕 立刻 就 会 变 成 这 种 新 的 随机 色 。 


Qi 在 调试 AirPlay 的 时 候 ，Reflector 是 个 非常 方便 的 辅助 程序 (单机 授权 的 价格 是 12.99 美 元 ，5 台 电脑 授权 的 价格 是 54.99 美 元 ， 网 站 
zehttp://reflectorapp.com) ， 可 以 在 既 不 使 用 线 绕 又 不 使 用 Apple TV 的 前 提 下 ， 把 设备 屏幕 中 的 内 容 传 播 到 Mac 及 Windows 电脑 上 。 该 软件 会 模拟 Apple TV 的 AitPlay 接 收 
器 ， 从 而 使 开发 者 可 以 把 iDS 设 备 屏幕 里 的 内 容 直 接 传播 到 电脑 桌面 ， 并 记录 设备 的 输出 。 


解决 方案 14-7 VIDEOKkit 


@protocol VIDEOkitDelegate <NSObject> 
- (void) updateExternalView: (UIView *) view; 
@end 


@interface VIDEOkit : NSObject 
@property (nonatomic, weak) UIViewController<VIDEOkitDelegate> *delegate; 
@property (nonatomic, strong) UIWindow *outputWindow; 
@property (nonatomic, strong) CADisplayLink *displayLink; 
+ (void) startupWithDelegate: 
(UIViewController<VIDEOkitDelegate> *)aDelegate; 
@end 


@implementation VIDEOkit 


| 


UIImageView *baseView; 


- (void)setupExternalScreen 

{ 
// Check for missing screen 
Xf (!SCREEN CONNECTED) return; 


// Set up external screen 
UIScreen *secondaryScreen = [UIScreen screens] [1]; 
UIScreenMode *screenMode - 

[[secondaryScreen availableModes] lastObject]; 
CGRect rect = (CGRect) {.size = screenMode.size}; 
NSLog(G"Extscreen size: $0", NSStringFromCGSize(rect.size)) ; 


// Create new outputWindow 

self.outputWindow - [[UIWindow alloc] initWithFrame:CGRectZero]; 
_outputWindow.screen = secondaryScreen; 
_outputWindow.screen.currentMode = screenMode; 

[ outputWindow makeKeyAndVisible]; 

_outputWindow.frame = rect; 


// Add base video view to outputWindow 


baseView - [[UIImageView alloc] initWithFrame:rect]; 
baseView.backgroundColor = [UIColor darkGrayColor] ; 
[ outputWindow addSubview:baseView]; 


// Restore primacy of main window 
[ delegate.view.window makeKeyAndVisible]; 


- (void)updateScreen 
{ 
// Abort if the screen has been disconnected 
if (!SCREEN CONNECTED && _outputWindow) 
self.outputWindow = nil; 


// (Re)initialize if there's no output window 
if (SCREEN CONNECTED && ! outputWindow) 
[self setupExternalScreen] ; 


// Abort if encounter some weird error 
if (!self.outputWindow) return; 
// Go ahead and update 
SAFE PERFORM WITH ARG( delegate, 
@selector (updateExternalView:), baseView) ; 


= (void) screenDidConnect: (NSNotification *)notification 


NSLog (@"Screen connected"); 
UIScreen *screen = [[UIScreen screens] lastObject] ; 


if ( displayLink) 
{ 
[ displayLink removeFromRunLoop: [NSRunLoop currentRunLoop] 
forMode :NSRunLoopCommonModes] ; 
[ displayLink invalidate] ; 
_displayLink = nil; 


self.displayLink = [screen displayLinkWithTarget:self 
selector:@selector (updateScreen) ] ; 

[ displayLink addToRunLoop: [NSRunLoop currentRunLoop] 
forMode:NSRunLoopCommonModes] ; 


- (void)screenDidDisconnect: (NSNotification *)notification 
{ 
NSLog (@"Screen disconnected."); 
if ( displayLink) 
{ 
[ displayLink removeFromRunLoop: [NSRunLoop currentRunLoop] 
forMode :NSRunLoopCommonModes] ; 
[ displayLink invalidate] ; 


self.displayLink = nil; 


- (instancetype)init 


{ 


self = [super init]; 
if (self) 


| 


// Handle output window creation 
if (SCREEN CONNECTED) 
[self screenDidConnect:nill; 


// Register for connect/disconnect notifications 


[[NSNotificationCenter defaultCenter] 
addObserver:self selector:Gselector(screenDidConnect:) 


name:UIScreenDidConnectNotification object:nil]; 
[[NSNotificationCenter defaultCenter] addObserver:self 

selector:Gselector(screenDidDisconnect:) 

name:UIScreenDidDisconnectNotification object:nil]; 


} 


return self; 


- (void)dealloc 


{ 


[self screenDidDisconnect:nill; 


+ (VIDEOkit *)sharedInstance 


static dispatch once t predicate; 
static VIDEOkit *sharedInstance - nil; 
dispatch once(&predicate, “{ 

sharedInstance - [[VIDEOkit alloc] init]; 


}); 


return sharedInstance; 


+ (void)startupWithDelegate: 
(UIViewController «VIDEOkitDelegate» *)aDelegate 


[[self sharedInstance] setDelegate:aDelegate] ; 


@end 


14.13 ”追踪 用 户 


STARA RR, Bi (tracking) 是 一 件 无 法 避免 的 事情 。UIlDevice 类 里 面 有 个 属性 ， 能 够 提供 与 设备 硬件 相关 联 的 唯一 标识 符 ， 但 是 苹果 公司 已 经 借用 该 属 
性 ， 并 用 另外 两 个 标识 符 属性 来 取代 它 。ASldentifierManager 类 的 advertisingldentifier 属 性 会 返回 针对 当前 设备 的 唯一 标识 符 ， 以 供 发 布 广告 之 用 。 而 UlDevice 类 
的 identifierForVendor 属 性 则 会 提供 与 每 个 程序 开发 商 相 关 的 标识 符 。 对 于 同一 台 设 备 上 面 由 同一 家 厂商 所 开发 的 各 种 程序 来 说 ， 这 个 唯一 标识 符 是 相同 的 。 但 它 并 
` 是 客 尸 ID (customer ID) 。 不 同 的 开发 商 所 制作 的 程序 ， 返 回 的 标识 符 是 不 同 的 ， 而 同一 个 开发 商 所 制作 的 程序 ， 在 不 同 的 设备 上 面 也 会 返回 不 同 的 标识 符 。 


这 些 标 识 符 是 用 新 的 NSUUID 类 来 构建 的 。 在 追 踊 之 外 的 场合 ， 也 可 以 使 用 该 类 来 创建 UUID 字 符 串 ， 它 能 保证 这 些 字符 串 的 全 局 唯一 性 。 苹 果 公 司 的 文档 中 
it: “UUID (Universally Unique ldentifier， 全 局 唯一 标识 符 ) 也 叫 作 GUID (Globally Unique ldentifier， 全 局 唯一 标识 符 ) 或 ID (Interface ldentifier， 接 口 
标识 符 、 界 面 标 识 符 ) ， 它 是 个 128 位 的 二 进 制 值 。UUID 能 够 在 空间 和 时 间 上 具备 唯一 性 。 它 是 由 两 个 值 组 合 起 来 的 ， 第 一 个 值 是 针对 生成 UUID 的 这 台电 脑 所 选取 的 
特定 值 ， 第 二 个 值 以 100 纳 秒 为 单位 来 描述 当前 时 刻 与 1582 年 10 月 15 日 0 时 0 分 0 秒 的 间 隅 。 


UUID 类 可 以 根据 需要 生成 符合 RFC 4122v4 标 准 的 新 版 UUID。[NSUUID UUID] 方 法 会 返回 新 的 UUID 实 例 (其 中 的 全 部 字母 都 是 大 写 ) 。 有 了 这 个 实例 之 后 ， 我 
们 可 以 通过 UUIDString 属 性 来 获取 对 应 的 字符 串 ， 也 可 以 用 getUUIDBytes: 方法 来 查询 它 的 字 节 形式 。 


14.14 ”查询 可 用 的 磁盘 空间 


NsFileManager 类 可 以 给 出 iPhone 上 面 的 可 用 空间 以 及 设备 的 总 空间 。 程 序 清 单 14-1 示 学 了 如 何 检测 并 显示 这 两 个 值 ， 它 会 在 数值 中 插入 逗号 ， 以 美化 字符 串 的 
格式 。 这 两 个 值 都 以 字 节 为 单位 ， 分 别 表示 设备 的 总 空间 及 可 用 空间 。 


程序 清单 14-1 ”获取 文件 系统 的 大 小 及 可 用 空间 


- (void)logFileSystemAttributes 
| 
NSFileManager *fm - [NSFileManager defaultManager]; 
NSDictionary *fsAttr - 
[fm attributesOfFileSystemForPath:NSHomeDirectory() 


error:nill; 


NSNumberFormatter *numberFormatter - 
[[NSNumberFormatter alloc] init]; 
numberFormatter.numberStyle - NSNumberFormatterDecimalStyle; 


NSNumber *fileSystemSize - 

[fsAttr objectForKey:NSFileSystemSize] ; 
NSLog(@"System space: %@ bytes", 

[numberFormatter stringFromNumber:fileSystemSize] ) ; 


NSNumber *fileSystemFreeSize = 

[fsAttr objectForKey:NSFileSystemFreeSize]; 
NSLog(@"System free space: $9 bytes", 

[numberFormatter stringFromNumber:fileSystemFreeSize]); 


14.15 “小 结 


本 章 讲解 了 与 iOs 设 备 互 动 的 一 些 关 键 方式 。 读 者 学 到 了 如 何 获取 设备 信息 、 如 何 检查 电池 状态 以 及 如 何 订阅 与 距离 感应 器 有 天 的 事件 。 我 们 还 学 习 了 和 垢 样 区 分 
iPod touch、iPhone 和 iPad， 以 及 怎样 判断 程序 所 在 的 设备 是 什么 型 号 。 笔 者 介绍 了 加 速 计 ， 并 通过 几 个 例子 演示 了 其 用 法 ， 告 诉 大 家 如 何 找 出 真正 的 “上 ”方向 、 
如 何 移动 屏幕 上 的 物体 ， 以 及 如 何 检测 晃动 操作 。 此 外 ， 还 介绍 了 Core Motion 框 架 ， 并 告诉 大 家 怎样 用 块 来 实时 地 响应 设备 事件 。 读 者 也 学 到 了 如 何 令 应 用 程序 把 
内 容 输 出 到 外 接 屏 幕 中 。 下 面 列 出 本 章 各 条 解决 方案 所 涉及 的 要 点: 


- App Store 允 许 开 发 者 执行 一 些 底 层 调用 。 苹 果 公 司 的 API 会 随 着 当前 固件 版 本 而 变化 ， 但 这 些 底层 调用 却 不 依赖 于 API。 虽 说 UNIX 有 系统 调用 看 上 去 比较 麻烦 ， 但 
是 很 多 系统 调用 都 能 够 在 OS 设备 上 面 执行 。 


: 向 iTunes 提 交 程 序 时 ， 可 在 Info.plist 文 件 里 面 规定 设备 必须 具备 何 种 能 力 ， 方 能 运行 本 程序 。iTunes 将 会 根据 文件 中 所 列 出 的 要 求 来 判断 程序 是 否 能 够 下 载 并 正 


确 运 行 在 某 台 设备 之 中 。 


开发 程序 时 ， 应 该 考虑 到 设备 的 各 种 限制 。 在 执行 大 批量 的 文件 操作 之 前 ， 应 该 先 检 查 可 用 的 磁盘 空间 ， 而 在 运行 CPU 负载 很 高 的 操作 之 前 ， 则 应 判断 电池 的 电 


: 研究 一 下 Core Motion 框 架 。 该 框架 可 以 实时 提供 设备 的 反馈 信息 ， 从 而 令 我 们 能 够 以 此 为 基础 ， 将 iDOS 设 备 同 真实 的 运动 效果 结合 起 来 。 


-iPhone 与 iPad 的 加 速 计 提 供 了 一 种 新 疾 的 手段 ， 用 以 补充 基于 触摸 的 界面 。 除 了 给 应 用 程序 设计 触摸 界面 之 外 ， 还 可 以 利用 加 速 计 的 数据 ， 令 用 户 能 够 以 倾斜 设 
备 的 方式 来 操作 程序 。 


: AirPlay 是 一 种 能 够 把 程序 内 容 分 享 到 外 接 屏幕 的 新 技术 ， 我 们 可 以 用 Video Out (视频 输出 ) 创建 出 许多 原来 无 法 想象 的 优秀 软件 项 目 。 将 AirPlay 和 外 部 显示 器 
结合 起 来 之 后 ，iOS 设 备 就 成 了 一 台中 控 器 ， 用 户 可 以 把 它 当 作 游 戏 手柄 ， 也 可 以 用 它 的 小 屏幕 来 操作 一 些 工具 软件 ， 以 便 把 内 容 显 示 在 大 屏幕 上 。 


第 15 草 ”辅助 功能 


通过 辅助 功能 ， 开 发 者 可 以 把 iOs 应 用 程序 提供 给 身体 有 障碍 的 人 士 使 用 。 系 统 的 General Settings 里 面包 含 一 些 辅 助 功能 ， 可 以 把 显示 的 内 容 放 大 ， 并 反 转 界面 
颜色 等 。 而 对 于 开 友 者 来 说， 辅助 功能 主要 是 围绕 着 VoiceOver 来 实现 的 ， 它 可 以 令 视 障 用 户 “ 听 ”到 程序 的 GUI。VoiceOver 能 够 以 声音 来 摘 述 程序 的 图 形 界面 。 


不 要 把 VoiceOver 与 Voice Control| 或 Siri 语 音 助 手相 混淆 。VoiceOver 能 够 以 声音 来 描述 Ul， 并 且 与 手势 结合 得 非常 紧密 ， 而 后 两 者 则 是 苹果 公司 的 语音 识别 专利 
技术 ， 能 够 在 不 用 手 操作 的 前 提 下 控制 手机 (hands-free interaction， 免 提交 互 ) 。 


本 草 人 简 述 VoiceOver 辅 助 功能 。 读 者 将 会 学 到 怎样 给 应 用 程序 添加 辅助 标签 和 提示 ， 以 及 如 何在 模拟 器 与 iOS 设 备 上 面 测试 这 些 功 能 。 辅 助 功能 可 以 在 第 三 代 及 后 
续 设备 上 面 使 用 并 测试 ， 包 括 所 有 型 号 的 iPad、3GS 及 后 续 型 号 的 iPhone， 以 及 第 三 代 及 后 续 机 型 的 iPod touch, 


15.1 辅助 功能 基础 知识 


为 UI 元 件 添加 描述 性 的 属性 ， 即 可 创建 辅助 功能 。 这 套 编程 接口 由 名 为 UIAccessibility 的 非 正式 协议 来 定义 ， 该 协议 包含 一 系列 属性 ， 其 中 包括 标签 (label) 、 
提示 (hint) 以 及 值 (value) 等 。 这 些 内容 合 在 一 起 ， 向 VoiceOver 提 供 信息 ， 使 它 可 以 把 程序 界面 用 语音 描述 出 来 。 


开发 者 可 以 在 代码 中 设置 这 些 属性 ， 也 可 以 通过 Interface Builder (IB) 来 添加 它们 。 程 序 清单 15-1 演 示 了 怎样 设置 按钮 的 accessibilityHint 属 性 。 该 属性 摘 述 了 
这 个 按钮 控件 如 何 响应 用 户 的 操作 。 本 例 中 ， 如 果 用 户 在 相关 的 文本 框 里 输入 用 户 名 ， 那 么 按钮 的 accessibilityHint 就 会 随 之 更 新 。 更 新 后 的 accessibilityHint 将 与 当 
前 的 UI 情 境 相符 。 程 序 不 再 宽泛 地 提示 此 按钮 可 以 打 电 话 ， 而 是 会 具体 地 说 出 它 能 打 给 谁 。 


程序 清单 15-1 以 编程 的 方式 更 新 辅助 功能 信息 


- (BOOL)textField: (UITextField *)textField 
shouldChangeCharactersInRange: (NSRange) range 
replacementString: (NSString *)string 


// Catch the change to the username field and update 
// the accessibility hint to mirror that 
NSString *username = textField.text; 
if (username && username.length > 1) 
callbutton.accessibilityHint = [NSString 
stringWithFormat:@"Places a call to $9", username]; 
else 
callbutton.accessibilityHint = 
@"Places a call to the person named in the text field."; 


return YES; 


UIAccessibility 协 议 包含 如 下 属性 : 


- acCessibilityTraits 一 一 用 于 表述 UI 元 件 的 一 系列 标志 。 这 些 标志 指明 了 控件 的 行为 ， 并 告诉 解释 系统 应 该 如 何 对 待 此 控件 。 比 方 说 ， 有 一 些 标志 与 状态 相关 ， 
描述 了 控件 是 否 处 于 受 选 或 启用 状态 ， 还 有 一 些 与 行为 相关 ， 描 述 了 控件 的 行为 是 否 与 按钮 类 似 。 


- accessibilityLabel 该 属性 是 描述 视图 角色 或 控件 动作 的 短语 (例如 Pause 或 Delete) 。 标 签 可 以 本 地 化 。 


accessibilityHint 一 一 该 属性 是 个 短语 ， 用 来 描述 用 户 可 以 通过 此 控件 执行 何 种 操作 (例如 转 到 主页 ) 。 该 属性 也 可 以 本 地 化 。 
- accessibilityFrame 一 一 该 矩形 描述 了 非 视图 的 元 件 应 该 如 何 显 示 在 屏幕 上 面 。 对 于 普通 的 UIView 视 图 来 说 ， 该 属性 就 是 其 frame 属 性 。 
- accessibilityPath 一 一 对 于 非 和 矩形 的 元 件 来 说 ， 可 以 用 UIBezierPath 来 描述 它 的 形状 ， 而 不 使 用 accessibilityFrame 来 描述 。 


- accessibilityValue 一 一 它 是 与 控件 相关 联 的 值 ， 比 如 滑 杆 的 当前 值 (例如 75%) 或 开关 的 状态 (例如 ON) 。 


用 iB 来 设置 辅助 功能 


开发 者 可 以 通过 |B 的 ldentity Inspector>Accessibility 面 板 (如 图 15-1 所 示 ) 给 界面 中 的 UIKit 元 件 添加 辅助 功能 。 这 些 文本 框 与 其 中 的 文本 在 辅助 功能 中 扮演 着 
不 同 的 角色 。1B 的 面板 里 所 展示 的 选项 ， 与 UIAccessibility 协 议 中 的 属性 是 相互 对 应 的 。Label 用 于 指明 视图 的 角色 ，Hint 用 来 描述 具体 的 操作 ， 这 与 通过 代码 设置 
UIAccessibility 属 性 是 一 样 的 。 除 了 上 述 文 本 框 之 外 ， 还 有 个 通用 的 Accessibility Enabled 复 选 框 ， 以 及 一 些 与 accessibilityTraits 有 关 的 复 选 框 。 
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图 15-1 开发 者 可 以 在 IB 的 Identity Inspectot 里 面 指定 控件 的 辅助 功能 信息 


15.2 ”启用 辅助 功能 


Enabled 复 选 框 用 来 决定 UIKit 视 图 是 否 与 VoiceOver 协 同 运 作 。 如 果 想 宣称 某 元 件 支 持 辅 助 功能 ， 需 要 以 代码 将 isAccessibilityElement 属 性 设 为 YES， 或 在 lB 里面 
选中 Accessibility Enabled 复 选 框 (如 图 15-1 所 示 ) 。 这 个 布尔 属性 用 来 表示 GUI 元 件 是 否 参 与 到 辅助 系统 之 中 。 上 默认 情况 下 ， 所 有 UIControl 实 例 的 
isAccessibilityElement 属 性 都 是 YES。 


一 般 来 说 ， 可 以 无 障碍 访问 的 子 视图 所 在 的 容器 不 开局 辅助 功能 ， 其 他 视图 都 应 该 开局 辅助 功能 。 也 融 是 说 ， 只 应 该 在 用 户 能 够 直接 操作 或 直接 看 到 的 控件 上 面 
启用 辅助 功能 。 用 来 容纳 其 他 视图 的 容器 在 语音 展示 系统 里 面 并 没有 实质 作用 ， 所 以 应 将 其 排除 在 外 。 


表格 视图 的 单元 格 能 够 很 好 地 说 明 什 么 是 可 以 无 障碍 访问 的 控件 所 在 的 容器 (容器 就 是 包含 其 他 对 象 的 对 象 ) 。 下 面 两 条 规则 适用 于 单元 格 : 
. 如 果 单 元 格 里 没有 座 入 控件 ， 那 么 该 单元 格 应 该 开启 辅助 功能 。 
` 如 果 单 元 格 里 庶 入 了 控件 ， 那 么 单元 格 本 身 不 应 开启 辅助 功能 ， 但 它 里 面 的 子 控件 应 开启 辅助 功能 。 


不 提供 辅助 功能 的 容器 ， 用 来 报告 其 中 包含 多 少 带 有 辅助 功能 的 子 视图 ， 以 及 这 些 子 视图 分 别 是 什么 。 请 参阅 苹果 公司 的 《Accessibility Programming Guide 
for iOS》， 以 便 深 入 了 解 如 何 为 与 辅助 功能 有 天 的 容器 编写 代码 。 对 于 自制 的 容器 视图 来 襄 ， 开 发 者 需要 为 其 声明 并 实现 UIAccessibilityContainer 协 议 。 
15.3 ”特征 


特征 (trait) 摘 述 了 UIKit 控 件 的 行为 。VoiceOver 采 用 特征 来 摘 述 程序 的 界面 。 如 图 15-1 所 示 ， 开 上 友 者 可 以 给 视图 设置 许多 特征 。 我 们 可 以 在 选 定 的 视图 上 面 设 
置 它 应 有 的 特征 ， 也 可 以 通过 编程 的 方式 来 修改 特征 。 


特征 可 用 来 向 VoiceOver 系 统 描述 界面 中 的 元 件 。 它 们 指明 了 控件 的 行为 ， 以 及 VoiceOver 应 该 如 何 对 待 此 控件 。 开 发 者 通过 accessibilityTraits 属 性 来 设置 特征 ， 
我 们 可 以 只 设置 一 个 标志 ， 也 可 以 用 OR 把 多 个 标志 组 合 起 来 ， 还 可 以 像 图 15-1 那 样 在 IB 里 面 设置 标志 。 这 些 特征 标志 的 运作 方式 不 同 ，VoiceOver 使 用 它们 的 方式 也 
不 同 。 


最 基本 的 标志 即 默 认 的 标志 是 “没有 特征 ”: 


- UlAccessibilityTraitNone 该 元 件 没 有 与 辅助 功能 有 关 的 特征 。 
除 此 之 外 ， 还 有 一 些 标志 用 来 描述 这 个 元 件 是 什么 ， 包 括 : 


- UlAccessibilityTraitButton 


该 元 件 是 按钮 。 


: UlAccessibilityTraitLink 


该 元 件 是 超 链接 。 


: UlAccessibilityTraitStaticText 


该 元 件 是 一 段 不 变 的 文本 。 


- UlAccessibilityTraitSearchField 一 一 该 元 件 是 搜索 框 。 
: UlAccessibilityTraitl mage—— —3Z 7L fF 2 BK. 
: UlAccessibilityTraitKeyboardKey 一 一 该 元 件 是 键盘 上 的 按键 。 


- UlAccessibilityTraitHeader 该 元 件 是 某 段 内 容 的 标题 。 


苹果 公司 的 辅助 功能 开发 文档 里 面 说 ，Button、Link、Sstatic Text 及 Search Field 这 四 个 标志 是 互 奈 的 ， 开 发 者 只 应 选择 其 中 之 一 。 如 果 某 个 按钮 本 身 也 是 链接 ， 
则 要 么 选择 Button， 要 么 选择 Link， 不 能 两 个 都 选 。 我 们 应 该 选择 最 能 描述 按钮 特征 的 标志 。 如 果 按 钮 可 以 显示 图 像 ， 并 且 能 在 点 击 的 时 候 友 出 声音 ， 那 么 可 以 随意 
指定 与 图 像 及 声音 有 关 的 特征 ， 而 不 必 考 虑 互 斥 问题 


下 面 几 个 状态 标志 可 用 来 描述 控件 是 否 受 选 、 是 否 可 以 调整 以 及 是 否 允 许 用 户 直 接 操作 它 : 
- UlAccessibilityTraitSelected 一 一 表示 该 控件 当前 处 于 受 选 状态 ， 可 用 来 描述 分 段 选择 控件 中 的 分 段 或 表格 中 的 行 。 
UlAccessibilityTraitNotEnabled 一 一 表示 该 控件 已 经 禁用 ， 用 户 无 法 操作 它 。 


- UlAccessibilityTraitAdjustable 一 一 表示 该 控件 可 以 有 多 个 取 值 ， 比 如 滑 杆 或 选取 器 控件 就 是 这 样 。 开 发 者 可 以 实现 accessibilityInctement 及 accessibilityDecrement 
方法 ， 以 规定 用 户 每 次 能 在 当前 值 的 基础 上 调整 多 少 。 


- UIAccessibilityTraitAllowsDirectlnteraction 一 一 表示 用 户 是 否 能 够 通过 和 触摸 来 直接 操作 该 控件 。 
如 果 控 件 在 用 户 操作 它 的 时 候 会 友 出 声音 ， 那 么 也 可 以 指定 下 面 这 个 标志 : 
UlAccessibilityTraitPlaysSound 一 一 表示 该 控件 会 在 激活 时 发 出 声音 。 
最 后 ， 还 有 一 些 状态 标志 用 来 摘 述 控件 的 行为 ， 并 告诉 用 户 该 控件 如 何 与 外 部 环境 互动 : 
- UIAccessibilityTraitUpdatesFreduently 一 一 表示 该 控件 变化 得 很 频繁 ， 所 以 用 户 不 需要 经 常 了 解 它 的 状态 变化 ， 比 方 说 秒表 的 读数 就 是 如 此 。 
: UIAccessibilityTraitStartsMediaS9ession 一 一 表示 该 控件 会 启动 一 段 媒体 会 话 。 播 放 或 录制 音频 、 视 频 时 ， 可 以 使 用 该 标志 ， 以 防 VoiceOvet 打 断 。 
“ UlAccessibilityTraitSummaryElement 一 一 表示 该 控件 会 在 应 用 程序 中 提供 摘要 信息 ， 例 如 当前 的 设置 或 状态 等 。 
UlAccessibilityTraitCausesPageTurn 一 一 表示 VoiceOvert 读 完 控 件 中 的 文本 之 后 ， 该 控件 会 自动 翻 页 。 


如 图 15-1 所 示 ， 大 部 分 (但 不 是 所 有 ) 特征 标志 都 可 以 通过 IB 的 Identity Inspector 面 板 来 切换 。 如 果 需 要 更 为 细致 地 控制 这 些 标 志 ， 需 要 使 用 代码 来 调整 它们 。 


15.4 标签 


accessibilityLabe| 属 性 用 来 设置 控件 的 辅助 功能 标签 。 好 的 标签 通常 会 用 一 个 词 向 用 户 描 述 出 控件 是 什么 。 我 们 应 该 像 设 置 按钮 文本 那样 设置 GUI 的 辅助 功能 标 
签 。Edit、Delete 和 Add 等 词 都 可 以 描述 出 控件 的 用 途 。 这 些 词 既 适合 用 作 按 钮 的 文本 ， 也 适合 用 作 辅 助 功能 标签 的 文本 。 


accessibilityLabel 属 性 并 不 局 限于 按钮 。 对 于 文本 视图 、 图 像 视图 以 及 文本 标签 来 说 ， 也 可 以 分 别 用 Feedback、User Photo 及 User Name 来 描述 其 内 容 及 功 
能 。 凡 是 在 视觉 界面 中 有 意义 的 控件 ， 都 应 该 能 在 VoiceOver 里 面 读 出 来 。 下 面 是 几 条 accessibilityLabeI 的 设计 技巧 : 


- 不 要 把 视图 的 类 型 写 在 标签 里 。 例 如 ， 不 要 把 标签 写成 “Delete button” (删除 按钮 ) ~ “Feedback text view” (反馈 文本 视图 ) X "User Name text field” (用 
户 名 文本 框 ) 。 由 于 VoiceOvet 会 自动 添加 视图 类 型 信息 ， 所 以 如 果 在 identity 面 板 里 把 标签 写成 “Delete button” (删除 按钮 ) ， 那 么 VoiceOvet 会 把 它 读 成 “Delete 
button button” (删除 按钮 按钮 ) 。 


: 将 标签 首 字母 大 写 ， 但 不 要 在 末尾 加 句点 。VoiceOvet 会 根据 大 小 写 情 况 来 决定 发 音 时 的 语调 。 如 果 给 标签 末尾 加 了 和 句点， 那么 VoiceOvet 一 般 会 以 降 调 来 发 音 ， 
这 样 读 出 来 的 语气 与 后 面 的 控件 类 型 名 称 听 起 来 不 搭 调 。“Delete.button” 的 发 音 听 上 去 很 怪 ， 而 “Delete button” 的 发 音 则 是 正确 的 。 


. 把 多 条 摘 述 信息 写 在 一 个 标签 里 。 如 果 某 些 复杂 的 视图 在 功能 上 是 一 个 整体 ， 那 么 可 以 把 这 些 视图 的 描述 信息 合 起 来 写 在 一 个 标签 里 ， 并 将 该 标签 设置 给 上 级 
图 


视图 。 比 方 说 ， 如 果 表 格 的 某 个 单元 格 里 有 许多 子 视图 ， 但 这 些 子 视图 都 不 是 独立 的 控件 ， 那 么 可 以 考虑 在 单元 格 的 标签 里 用 一 段 文本 把 这 些 子 视图 全 部 描述 出 来 。 
: 只 在 用 户 直 接 操 作 的 视图 上 面 设置 标签 。 如 果 用 户 需要 直接 操作 子 视 图 ， 那 就 在 子 视图 级 别 上 设置 标签 ， 而 不 要 给 包含 子 视 图 的 上 级 视图 设置 标签 。 


` 本 地 化 。 将 辅助 功能 字符 串 本 地 化 ， 以 尽量 扩大 程序 的 目标 用 户 。 


15.5 ”提示 语 


accessibilityHint 属 性 用 来 设置 控件 的 提示 信息 。 提 示 信 息 可 以 告诉 用 户 操 作 该 控件 的 效果 。 当 这 种 效果 不 太 明 显 的 时 候 ， 更 应 该 指定 提示 人 信息。 比方 说 ， 界 面 里 
有 个 人 名 是 John Smith， 用 户 点 击 了 名 字 之 后 ， 程 序 会 给 这 个 人 拨 电 话 。 由 于 名 字 本 身 并 没有 摘 述 出 用 户 操作 该 控件 后 的 效果 ， 所 以 我 们 应 该 添加 一 条 提示 语 ， 告 诉 
用 户 操作 该 控件 之 后 会 发 生 什 么 事情 。 比 方 说 ， 可 以 把 accessibilityHint 设 置 成 “Places a phone call to this person” (给 这 个 人 打 电 话 ) ， 或 是 设置 成 更 为 贴切 
AY “Places a phone call to John Smith" (给 John Smith 打 电话 ) 。 下 面 给 出 一 些 设置 accessibilityHint 的 技巧 : 


- 采用 句子 的 形式 给 出 提示 语 。 提 示 语 应 该 以 大 写字 母 开头 ， 并 以 句点 结尾 。 即 便 把 隐 含 的 主语 省 略 掉 ， 也 依然 要 采用 句子 的 形式 。 比 方 说 ， 在 省 略 主语 “This 
button” (该 按钮 ) 的 情况 下 ， 应 该 把 提示 语 写 成 “Cleatrs textin the form.” (清除 表单 中 的 文本 ) 。 采 用 这 种 形式 可 以 保证 VoiceOvet 能 够 以 正确 的 音调 来 发 声 。 


- 动词 用 来 描述 控件 所 做 的 事情 ， 而 不 是 用 户 所 做 的 事情 中。 我 们 应 该 告诉 用 户 “[Ihis text label]Places a phone call to this person." ([ 该 文本 标签 用 来 ] 给 这 个 人 打 电 
话 ) ， 而 不 是 “[You will]Place a phone call to this person.” (|[ 你 会 ] 给 这 个 人 打 电 话 ) 。 


不 要 写 上 GUI 元 件 的 名 称 或 类 型 。 不 要 在 提示 语 里 面 提 到 待 操作 的 UI 控 件 。GUI 的 名 字 (也 就 是 它 的 标签 ， 比 如 “Delete”) 及 类 型 (也 就 是 它 所 属 的 类 ， 比 
Jv "button" ) 都 不 应 该 出 现 。VoiceOvet 会 根据 需要 自动 添加 这 些 信息 ， 我 们 不 要 叫 它 读 出 多 余 的 词 。 假 如 把 这 两 个 信息 都 写 入 提示 语 ， 那 么 说 出 来 的 话 就 会 变 
成 “Delete button[ 这 个 button 是 标签 里 的 ]button[ 这 个 button 是 VoiceOvet 自 动 补充 的 ]button[ 这 个 button 是 提示 语 里 的 ]femoves item from screen.” 。 使 用 简洁 的 “Removes 


item from screen." 就 好 。 


. 不 要 提 到 操作 方式 。 不 要 在 提示 语 里 给 出 用 户 操 作 该 控件 的 方式 。 不 要 把 提示 语 写 成 “Swiping places a phone call to this person” (通过 滑动 来 给 这 个 人 打 电 话 ) 
或 “Tapping places a phone call to this person" (点 击 控件 来 给 这 个 人 打 电 话 ) 。 由 于 VoiceOvet 使 用 它 自己 的 一 套 手 势 来 激活 GUI 元 件 ， 所 以 不 要 在 提示 语 里 直接 描述 手 
势 。 


- 把 效果 摘 述 得 详细 一 些 。 描 述 控 件 的 效果 时 ，“ 了 Places cal” ( 打 电 话 ) 这 个 说 法 不 如 “Places a call to this person" 好 (给 这 个 人 打 电 话 ) ， 而 它 又 不 如 “Places a 
call to John Smith" (John Smith 打 电话 ) 好 。 提 示 语 要 能 够 简短 而 详尽 地 告诉 用 户 该 操作 的 效果 ， 但 又 不 能 太 过 简单 ， 以 致 用 户 必须 猜测 才能 知道 结果 。 不 要 使 用 那 


种 用 户 必 须 听 第 二 遍 才 能 明白 的 提示 语 。 


. 本 地 化 。 与 标签 一 样 ， 提 示 语 也 应 该 本 地 化 ， 以 便 尽量 扩大 目标 用 户 。 


[1 动词 应 该 酌情 使 用 第 三 人 称 单 数 形式 。 译 者 注 


15.6 ”用 模拟 器 测试 辅助 功能 


部 署 到 iOS 设 备 之 前 ， 可 以 用 模拟 器 的 Accessibility Inspector 来 测试 市 有 辅助 功能 的 程序 。 模 拟 器 的 Accessibility Inspector 能 够 在 不 直接 使 用 VoiceOver 手 势 的 
前 提 下 ， 模 仿 VoiceOver 的 操作 效果 ， 并 通过 浮动 面板 来 提供 即时 的 视觉 反 馈 (但 不 会 发 出 声音 ) 。 由 于 很 多 VoiceOver 手 势 都 无 法 用 模拟 器 来 重 现 (比方 说 triple- 
swipe 手 势 (三 指 滑 动 、 三 指 扫 屏 ) 及 连续 的 hold-then-tap 手 势 ( 按 住 然 后 点 击 ) ) ， 所 以 Accessibility Inspector 着 重 于 表述 界面 元 素 ， 而 不 是 响应 VoiceOver 手 
势 。 


打开 Settings> General>Accessibility， 即 可 启用 此 特性 。 把 Accessibility Inspector 开 关 打 开 之 后 ，Inspector 就 会 立刻 出 现在 屏幕 上 ， 如 图 15-2 所 示 。 它 会 显示 
出 当前 选 定 的 无 障碍 访问 元 件 的 设置 。 
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15-2 iPad4& 42 28 49 Accessibility Inspectot 面 板 会 显示 出 当前 选 定 的 GUI 元 件 所 具备 的 辅助 功能 属性 ， 例 如 标签 (label) 、 提 示 语 (hint) 等 


Qi. 革 果 公司 目前 的 Xcode 5 开发 工具 ， 并 不 能 正确 地 模拟 出 Accessibility Inspectorf。 革 果 公 司 应 该 会 在 将 来 的 更 新 中 修复 这 一 问题 。 此 处 给 出 的 截图 ， 是 根据 
Xcode 5 中 的 效果 与 Xcode 4.6 里 正确 的 Inspector 效 果 合 成 出 来 的 。Xcode 5 里 正确 的 Accessibility Inspector， 应 该 与 此 处 的 截图 相似 。 


启用 与 禁用 Inspector 的 方法 是 : 点 击 Inspector 左 上 角 的 圆 形 x 按 钮 。 点 击 一 次 之 后 ， 就 会 禁用 Inspector， 并 将 其 变 为 一 条 线 。 册 次 点 击 ， 即 可 恢复 并 启用 
Inspector。 在 大 多 数 情 况 下 ， 都 应 该 禁用 Inspector， 直 到 我 们 真 的 想 检 视 某 个 GUI 控 件 为 止 。 图 15-3 演 示 了 Accessibility Inspector 中 的 按钮 界面 。 


与 VoiceOver 一 样 ，Accessibility Inspector 也 会 干扰 正常 的 应 用 程序 手势 。 它 会 减缓 程序 测试 工作 ， 所 以 只 应 该 偶尔 用 一 下 (一 般 来 说 ， 应 该 在 测试 辅助 功能 的 
时 候 使 用 ) 。 我 们 可 以 在 禁用 Accessibility Inspector 但 将 其 保留 的 前 提 下 启动 应 用 程序 ， 等 切换 到 需要 调试 辅助 功能 的 画面 时 再 局 用 它 。 
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图 15-3  JEAccessibility Inspector 中 可 以 看 到 开发 者 通过 IB 或 代码 为 当前 所 选 控件 设 定 的 值 


如 果 用 编程 的 方式 来 修改 辅助 功能 的 提示 语 ， 那 么 Accessibility Inspector 会 实时 更 新 ， 以 反映 这 些 变化 。 把 Accessibility Inspector 激 活 之 后 ， 融 可 以 观察 到 当前 
的 提示 语 何 时 发 生 改 变 了 ， 它 会 确保 屏幕 上 显示 的 提示 语 和 标签 与 界面 中 的 相符 。 


15.7 ”把 变化 情况 传播 出 去 


屏幕 上 的 元 素 如 果 不 是 因为 用 户 的 直接 操作 而 友 生 变化 ， 应 用 程序 就 应 该 向 VoiceOver 辅 助 功能 系统 投递 通知 ， 令 其 知晓 这 一 情况 : 
- 添加 或 移 除 GUI 元 件 时 ，UIAccessibilityLayoutChangedNotification 通 知 可 以 令 VoiceOvet 辅 助 功能 系统 立刻 获知 相关 变化 。 


- 完成 滚动 操作 之 后 ， 程 序 应 该 投递 UIAccessibilityPageSctolledNotification 通 知 。 通 知 对 象 应 该 包含 一 条 描述 新 位 置 的 信息 (例如 ，“Page 50f17” (17 页 中 的 第 5 


A4) 或 “Tab 2of4 (4 个 分 页 中 的 第 2 个 分 页 ) ) 。 


. 如 果 放 大 后 的 控件 有 了 变化 ， 那 么 应 该 发 送 UIAccessibilityZoomFocusChanged 通 知 。 发 送 通知 时 还 应 该 指定 type、ftame 及 view 这 三 个 参数 。 第 一 个 参数 表示 放大 
类 型 ， 第 二 个 参数 表示 当前 放大 的 ftame (以 屏幕 坐标 来 衡量 ) ， 第 三 个 参数 表示 包含 放大 的 frame 的 视图 。 


除了 上 面 这 些 通知 之 外 ， 还 可 以 通过 VoiceOver 辅 助 系统 来 广播 通用 的 布告 。UIAccessibilityAnnouncementNotification 接 收 一 个 参数 ， 表 示 包 含 布告 内 容 的 字 
符 串 。 如 果 GUI 友 生 了 微小 的 变化 ， 屏 幕 上 发 生 了 短暂 的 变化 ， 或 是 发 生 了 不 会 直接 影响 UI 的 变化 ， 那 么 可 以 用 它 来 通知 用 户 。 


15.8 ”在 iOS 上 面 测试 辅助 功能 


对 于 辅助 功能 的 开发 来 说 ， 在 iPhone 或 iPad 上 面 进行 测试 是 很 重要 的 一 部 分 。 设 备 上 面 可 以 看 到 VoiceOver 的 实际 效果 ， 而 不 像 模 拟 器 那样 只 有 窗口 式 的 
Inspector。 开 发 者 可 以 听 到 用 户 应 该 会 听 到 的 声音 ， 并 且 可 以 用 手 和 耳 灯 来 测试 GUI， 而 不 再 需要 去 观察 Inspector 中 的 内 容 了 。 


与 模拟 器 一 样 ，iPhone 也 能 够 即时 局 用 并 茶 用 VoiceOver。 我 们 可 以 在 Settings 中 局 用 VoiceOver， 然 后 企 VoiceOver 持 续 运 行 的 状态 下 测试 应 用 程序 。 不 过 ， 还 
有 个 特殊 的 切换 方式 ， 要 比 这 个 办 法 更 简单 。 这 个 特殊 的 切换 方式 不 需要 用 VoiceOver 手 势 从 Settings 切 换 到 程序 ， 可 以 把 VoiceOver 关 掉 ， 用 普通 的 iOSs 操 作 来 启动 
程序 ， 然 后 等 到 需要 测试 的 时 候 再 局 用 VoiceOver。 


按照 下 列 步 骤 即 可 切换 VoiceOver: 
1. 打 开 Accessibility 设 置 面板 。 通 过 Settings>General>Accessibility 即 可 找到 这 个 面板 。 
2. 找 到 Accessibility Shortcut， 并 点 击 它 ， 然 后 会 看 到 一 系列 辅助 功能 操作 ， 它 们 可 以 用 作 三 击 Home 按 钮 时 的 目标 动作 。 


3. 把 VoiceOver 选 为 三 击 Home 按 钮 的 目标 动作 。 选 好 之 后 (其 右边 会 出 现 对 勾 ) ， 我 们 就 可 以 通过 连续 点 击 三 次 1OS 设 备 的 Home 键 来 启用 或 禁用 VoiceOver 
了 。 用 户 可 以 听 到 语音 提示 ， 以 确认 当前 的 VoiceOver 设 置 。 


这 种 VoiceOver 切 换 方式 ， 使 得 开发 者 在 操作 应 用 程序 时 可 以 跳 过 很 多 繁琐 的 三 指 拖 放 和 多 级 按钮 点 击 操作 。 不 过 ， 我 们 也 应 该 熟悉 VoiceOver 的 手势 和 操作 方 
法 。 表 15-1 列 出 了 测试 程序 时 可 以 用 到 的 VoiceOver 手 势 。 


表 15-1 操作 程序 时 常用 的 VoiceOvet 手 势 


ff 35 VoiceOver 手势 
切换 VoiceOver : 击 设 备 的 Home 按钮 
Hja ScreenCurtain - 指 三 击 屏幕 (也 就 是 用 三 根 手指 三 次 点 击 屏幕 ) 


用 三 根 手指 双击 屏幕 ， 即 可 彻底 切换 VoiceOver 语音 功能 (而 不 是 只 
针对 某 个 条 目 ) 
用 两 根 手 指 双 击 屏 幕 。 重 复 ; 
停止 说 出 当前 条 目 li H] VoiceOver AY EF AE UX FF 
播放 音乐 
方式 1 : 用 一 根 手 指点 击 并 按 下 某 个 条 目 不 放 ， 然 后 用 另 一 根 手 指点 
激活 某 条 目 〈 例 如 激活 某 个 按钮 ) ii BE 
方式 2: 点 击 某 个 条 目 以 选中 它 。 然 后 双击 屏幕 ， 激 活 此 条 目 
—— m 选中 可 以 编辑 的 文本 视图 或 文本 框 之 后 ， 用 一 根 手 指 问 上 或 回 下 拨 SUPE 
Vid BE SCANT ALS " au : 可 能 会 移动 一 个 字符 
诬 。 根 据 设备 的 配置 ， 插 入 点 可 能 会 移动 一 个 字 什 ， 也 可 能 会 移动 一 个 词 
选中 可 以 编辑 的 文本 视图 或 文本 框 之 后 ， 把 两 根 手指 放 在 屏幕 上 ， 然 
后 顺 时 针 或 逆 时 针 旋 转 。 这 个 手势 叫 作 rotor 
设 定 插 入 点 并 进入 文本 编辑 模式 。 双 指 张 开 可 以 选中 文本 ， 双 指 聚 拢 
可 以 取消 选择 文本 
选中 文本 框 EE 或 文本 ALA], SUR OGRE, DEA SCA ish JCA BE 
c bib aN CE BE EE 
输入 文本 方式 1 : 用 左手 食指 点 击 并 按 住 键盘 上 n Te 用 右手 食指 点 击 屏 
谊 上 的 其 他 地 方 。 如 果 eji Delete 键 ， 这 就 是 最 好 的 办 法 
方式 2: 点 击 某 个 键 以 选中 它 。 双 击 屏 幕 以 


切换 VoiceOver 语音 


文 一 手势 ， 即 可 继续 语音 播报 Mc 
3. ABA TUBAE ESI S AES 


访问 VoiceOver 菜单 ， 以 调整 语音 设置 


选中 文本 或 取消 选择 文本 


—À..X 

\ T 
AU 
TEM 


ft 3 VoiceOver 手势 

移动 请 杆 选中 滑 杆 ， 然 后 用 一 根 手 指向 上 或 向 下 拨 动 屏幕 ， 以 调整 它 的 值 

问 上 或 问 P BR 用 三 根 手 指 问 上 或 回 下 拨 动 屏幕 

[3] Zr: a, [8] £4 i] V FA AR FHE n Ze sx npa 22 oh BE 

EPNER 日 点 击 某 条 目 

FFF BIE PPL Te DHE A AY H ui m x: is Fiala] Eskis] PRS AE. VoiceOver 会 根据 rotor 3E P. rP Egi 
AKAH 

移 到 下 一 个 或 上 一 个 条 目 FAA FHK i Ze eX p 3 27] AE 

用 两 根 手 指 问 上 拨 动 屏幕 。 这 种 操作 方式 未 必 能 够 见效 。 也 可 以 改 用 

Beth d BEARES. AY 万 一 种 方式 : 反复 回 左 拨 : 3 pt 幕 ， 移 到 首 个 条 目 。 然 后 用 双 指 回 下 拨 动 
的 手势 从 当前 选中 的 条 目 回 后 庶 

BI 选 定 解 锁 用 的 滑 杆 ， 然 后 单 指 双击 屏幕 


特别 注意 Screen Curtain 功 能 ， 它 可 以 令 设 备 屏 幕 变 为 空白 ， 从 而 使 开发 者 可 以 真正 测试 基于 语音 的 界面 。 启 用 Screen Curtain ， 然 后 操作 iPhone 的 计算 器 程 
序 ， 试 试 如 何在 看 不 到 屏幕 内 容 的 情况 下 使 用 该 程序 。 


153 语音 合 


苹果 公司 在 iOS 7 中 添加 了 文字 转 语音 的 功能 ， 这 对 于 辅助 功能 和 其 他 任务 来 说 都 是 非常 有 用 的 工具 ， 可 以 帮助 用 户 浏览 内 容 或 增加 程序 的 趣味 。 可 以 用 
AVspeechsynthesizer 和 AVspeechUtterance 类 来 说 出 任意 字符 串 。 对 于 长 篇 文本 来 说 ， 这 项 功能 非 名 方便 ， 它 令 开 上 友 者 可 以 获得 比 使 用 VoiceOver 时 更 为 精细 的 控 
制 权 ， 从 而 能 够 以 编程 的 万 式 控制 语音 ， 包 括 选 定 友 音 内 容 和 时 机 ， 以 及 调整 音调 和 语 速 等 。 此 外 ， 即 便 用 户 不 使 用 辅助 功能 ， 语 音 合成 也 依然 有 效 。 


程序 清单 15-2 演 示 了 如 何 从 可 供 使 用 的 英语 友 音 中 随机 选择 一 种 ， 并 以 它 来 说 出 简单 的 字符 串 。 只 需 稍微 修改 一 下 代码 ， 融 可 以 损 用 其 他 语言 和 地 域 口音 来 友 声 


A= 


了 。 使 用 AVSpeechSynthesisVoice 可 以 选 定 某 一 种 语言 ， 也 可 以 遍历 可 供 使 用 的 各 种 语言 。 


程序 清单 15-2 ”使 用 iOS 7 的 文字 转 语音 功能 


- (void)action 
| 
// Establish a new utterance 
AVSpeechUtterance *utterance - 
[AVSpeechUtterance speechUtteranceWithString: 
@"Hello there you beautiful world!"]; 
// Slow down the rate 
utterance.rate = AVSpeechUtteranceMinimumSpeechRate + 
(AVSpeechUtteranceMaximumSpeechRate - 
AVSpeechUtteranceMinimumSpeechRate) * 0.2f; 


// Set the language 
utterance.voice = [self anotherVoiceForLanguage:G"en"]; 


// Speak 

AVSpeechSynthesizer *synthesizer - 
[[AVSpeechSynthesizer alloc] init]; 

[synthesizer speakUtterance:utterance]; 


- (AVSpeechSynthesisVoice *)anotherVoiceForLanguage: 
NSString *)lang 


srand (time (NULL)); 
NSArray *voices - [AVSpeechSynthesisVoice speechVoices]; 
NSMutableArray *voicesForLanguage - 
[[NSMutableArray alloc] init]; 
for (AVSpeechSynthesisVoice * voice in voices) 
| 
if ([voice.language hasPrefix:langl) 
[voicesForLanguage addObject:voice]; 
| 
NSUInteger voiceIndex - 
rand() $ voicesForLanguage.count; 
return voicesForLanqguage [voiceIndex]; 


15.10 ”动态 字体 


一 直 以 来 ，iOS 的 辅助 功能 都 可 以 令 应 用 程序 与 某 些 能 力 相配 合 ， 并 适应 很 多 限制 。iOS 7 已 经 把 这 套 设 计 理 念 融入 许多 日 音 的 应 用 程序 之 中 。 用 户 可 以 调整 显示 
设置 ， 以 影响 设备 上 所 安 六 的 全 部 程序 。 


General» Text Size 中 的 一 项 设置 可 以 调整 所 有 程序 的 阅读 字体 大 小 ， 包 括 字 体高 度 、 行 高 以 及 行 间 距 (如 图 15-4 所 示 ) 。 视 力 较 好 的 年 轻 用 户 可 以 把 字体 调 小 ， 
以 便 在 屏幕 中 显示 更 多 内 容 。 而 视力 较 差 的 老年 用 户 则 可 以 通过 拖 岛 滑 块 把 字体 调 大 。 


要 想 在 程序 中 使 用 动态 字体 (Dynamic Type) ， 必 须 通过 preferredFont-ForTextStyle 方 法 来 选择 字体 ， 并 传 入 下 列 几 种 样式 之 一 : UlFontTextStyle- 
Headline、UlFontTextStyleSubheadline、UlFontTextStyleBody、UlFont-TextStyleFootnote、UlFontTextStyleCaption1 或 UIFontText-StyleCaption2。 如 果 我 
们 不 直接 指定 字体 名 称 和 大 小 ， 而 是 米 用 这 些 预 先 配 置 好 的 文本 样式 ， 那 么 iOS 会 根据 通用 设 定 来 选取 样式 及 大 小 合适 的 字体 。 


为 了 响应 用 户 对 文本 大 小 所 做 的 修改 ， 我 们 需要 监听 UlIContentSizeCategoryDidChangeNotification， 并 适当 地 更 新 Ul: 


UIViewController | weak *weakself = self; 


[[NSNotificationCenter defaultCenter] 
addObserverForName:UIContentSizeCategoryDidChangeNotification 
object:nil 
queue: [NSOperationQueue mainQueue] 
usingBlock:^(NSNotification *note) { 

UIViewController *strongSelf - weakself; 

[strongSelf performSelector:Gselector(updateLayout)]; 


aE 
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< General Text Size 


Apps that support Dynamic Type 
will adjust to your preferred 
reading size below. 


Drag the slider below 


图 15-4 ”在 iOS 7 中 ， 只 需 拖 动 系统 设置 中 的 一 个 滑 杆 ， 即 可 调整 所 有 程序 的 文本 大 小 


如 果 使 用 Auto Layout 及 标准 的 UIKit 文 本 元 件 ， 那 么 大 部 分 工作 都 会 由 系统 自行 处 理 。 重 置 UlLabel 或 UITextView 的 字体 ， 一 般 都 会 使 得 控件 的 固有 内 容 尺寸 
(intrinsicContentSize) 失效 ， 并 人 迫使 它 重新 布局 。 但 如 果 开 发 者 是 根据 frame 来 手工 布局 ， 就 需要 调用 setNeedsLayout 来 重新 布局 了 。 


15.111 小 结 
iOS 应 用 程序 支持 辅助 功能 之 后 ， 可 以 更 加 积极 地 参与 到 更 为 广泛 的 软件 市 场 之 中 ， 并 吸引 更 多 的 用 户 。 下 面 列 出 本 章 要 点 : 


. 和 程序 界面 的 本 地 化 一 样 ， 如 果 给 程序 添加 与 辅助 功能 有 关 的 标签 和 提示 语 ， 就 可 以 吸引 新 的 用 户 。 添 加 这 些 信息 所 需 的 工作 量 很 少 ， 但 却 能 给 用 户 带 来 很 大 
好 处 。 


用 IB 给 程序 设计 声音 界面 时 ， 要 分 清 标 签 和 提示 语 的 用 途 。 
` 尝试 用 编程 的 方式 来 修改 提示 语 。 我 们 可 以 根据 界面 当前 的 情况 来 更 新 提示 语 ， 以 便 给 视 障 人 士 提 供 最 佳 的 用 户 体 验 。 
. iOS 的 辅助 功能 系统 是 不 断 演 化 的 。 随 时 留意 苹果 公司 的 开发 文档 ， 以 便 了 解 最 近 的 更 新 和 变动 。 


- 在 开启 Screen Cuttain 的 情况 下 测试 程序 。 由 于 屏幕 上 不 会 显示 内 容 ， 所 以 我 们 能 够 更 好 地 模拟 出 用 户 通过 VoiceOvet 来 操作 程序 时 的 情景 。 


附录 A Objective-C 字 面 量 


写 代 码 的 时 候 ， 我 们 经 常 需要 用 饼干 切割 刀 一 样 的 INSNumber numberWith-Integer: 5] 模 板 来 制作 NSNumber 对 象 。 有 的 开发 者 也 许 定义 了 一 些 宏 ， 以 简化 
编码 工作 。 从 Xcode 4.4 (及 LLVM 4.0) 起 ， 开 发 者 可 以 通过 精简 且 易 读 的 表达 式 来 使 用 Objective-C 字 面 量 ， 而 不 用 再 像 原 来 那样 ， 用 复杂 的 代码 去 创建 NSNumber 
及 NSArray 等 实例 。 


笔者 以 前 也 定义 并 使 用 了 一 些 可 以 简化 NSNumber 声 明 的 宏 ， 但 是 现在 感觉 使 用 字面 量 可 以 写 出 更 易 看 懂 有 更 为 精简 的 代码 。 这 些 字 面 量 令 我 们 能 够 少 输入 一 些 
代码 ， 而 且 提供 了 一 种 自然 而 一 致 的 代码 风格 。 


现在 不 用 再 写 各 种 各 样 的 声明 了 ， 而 是 可 以 使 用 像 @5? 这 样 简 单 的 字面 量 。 这 种 数字 字面 量 与 大 家 一 直 企 使 用 的 字符 串 了 字面 量 非 贡 相似。 字符 串 字 面 量 残 是 在 @ 符 
号 后 面 跟 上 字符 串 常量 (比方 说 @"hello") ， 而 数字 字面 量 则 是 在 @ 符 号 后 面 跟 上 数值 。 还 有 一 些 类 似 的 字面 量 ， 可 以 简化 NSDictionary 及 NSArray 的 创建 及 查询 。 


这 项 新 技术 令 原 来 元 长 的 写法 变 得 简洁 了 许多 。 


通过 LLVM Clang 编 译 器 所 提供 的 机 制 ， 开 发 者 可 以 在 Xcode 中 把 整数 及 浮 点 数 等 标量 值 以 数字 字面 量 的 形式 封装 到 对 象 容器 里 面 。 只 需 给 标量 前 面 加 上 @。 比 方 
说 ， 下 面 代 码 可 以 把 2.7182818 转 为 对 应 的 NSNumber 对 象 : 


NSNumber *eDouble = @2.7182818; 
上 面 的 数字 字面 量 在 功能 上 与 下 面 写 法 等 效 : 
NSNumber *eDouble = [NSNumber numberWithDouble: 2.7182818]; 


这 种 方式 与 原来 的 区 别 在 于 ， 编 译 器 会 目 动 把 复杂 的 事情 处 理 好 。 开 友 者 不 需要 调用 类 的 方法 ， 不 需要 完整 地 写 出 方法 ， 也 不 需要 使 用 一 对 方 括号 。 我 们 只 需 和 在 
数值 前 面 加 上 @ 束 可 以 了 ， 剩 下 的 事情 Clang 会 做 。 


通过 标准 的 后 缀 可 以 定义 浮 点 数 (F) 、 长 整数 (L) 、 超 长 整数 (LL) 和 无 符号 整数 (U) 。 下 面 举 例 说 明 这 些 后 缀 的 用 法 。 每 条 声明 语句 都 很 简单 ， 我 们 不 再 需 
要 调用 与 数值 类 型 相对 应 的 专门 方法 了 : 


NSNumber *two = 92; // [NSNumber numberWithInt:2]; 

NSNumber *twoUnsigned - 92U; // [NSNumber numberWithUnsignedInt :2U] ; 
NSNumber *twoLong = @2L; // [NSNumber numberWithLong:2L]; 

NSNumber *twoLongLong - G2LL; // [NSNumber numberWithLongLong:2LL] ; 
NSNumber *eDouble = @2.7182818; // [NSNumber numberWithDouble: 2.7182818]; 
NSNumber *eFloat = @2.7182818F; // [NSNumber numberWithFloat: 2.7182818F]; 


(Ae, Canil bH AERARMEA RAEAN, MERA THAR RA. BLA, RBA AE: 
NSNumber *eLongDouble = @2.7182818L; // Will not compile 
布尔 型 的 常量 @YES 与 @ NO 会 产生 与 [NSNumber numberWithBool: YES] 及 [NSNumber numberWithBool: NO] 相 等 价 的 对 象 。 
最 后 要 注意 ， 在 Xcode 4.5 及 后 续 版 本 中 ， 开 发 者 可 以 使 用 @-5 这 种 写法 。 我 们 不 再 需要 把 值 放 到 括号 中 。 
A.2 ZB 


使 用 Xcode 4.4 时 ,我 们 只 能 在 @ 符 号 后 面 写 上 字面 标量 常数 。 如 果 想 先 用 算式 表达 某 个 值 ， 然 后 将 该 值 转 为 数值 对 象 ， 束 要 使 用 传统 形式 的 方法 调用 语句 : 


NSNumber *two = [NSNumber numberWithInt: (1+1)]; 


Xcode 4.5 支 持 装 箱 表 达 式 ， 从 而 免 去 了 上 面 这 种 麻烦 的 写法 。 所 谓 装 箱 表 达 式 ， 就 是 一 种 可 以 解释 并 转换 成 NSNumber 对 象 的 值 。 六 箱 表 达 式 两 端 要 加 括号 ， 
编译 器 会 求 出 表达 式 的 值 ， 然 后 将 其 转 为 对 象 。 例 如 : 
NSNumber *two = @(1+1); 
以 及 


int foo = ...; // some value 
NSNumber *another - G(foo); 


妆 箱 表达 式 并 不 局 限于 数值 ， 它 们 也 适用 于 字符 串 。 下 面 赋 值 语句 可 以 求 出 strstr(0 的 结果 ， 并 把 结果 转 为 NSstring 形 式 (也 就 是 @"World! ") : 


NSString *results = @(strstr("Hello World!", "W")); 
DES 
半 箱 表达 式 还 有 其 他 一 些 用 途 ， 比 方 说 枚 举 。 你 也 许 认 为 定义 好 枚 举 之 后 ， 应 该 能 够 直接 将 其 名 称 放 在 @ 符 号 后 面 使 用 ， 但 这 样 做 会 有 问题 。 例 如 ， 下 面 这 个 枚 
举 的 名 字 选 得 不 好 : 


enum (interface, implementation, protocol]; 


你 可 能 党 得 下 面 语句 能 够 创建 值 为 2 的 NSNumber: 
NSNumber *which = @protocol; 
假如 允许 上 面 写 法 的 话 ， 显 然 会 相当 糟糕 。 而 通过 装 箱 表达 式 来 使 用 枚 举 ， 则 不 会 和 当前 及 将 来 以 @ 开 头 的 关键 字 产 生 冲 突 : 


NSNumber *which = @(protocol); // [NSNumber numberWithInt:2]; 


A3 ”容器 字面 量 
容器 字面 量 也 是 LLVM Clang 编 译 器 中 一 个 非常 有 用 的 功能 。 在 支持 容器 字面 量 之 前 ,我 们 必须 及 用 下 面 写法 来 创建 字典 及 数组 ， 这 段 代码 创建 了 包含 三 个 元 素 的 
数组 ， 以 及 包含 三 个 键 的 字典 : 


NSArray *array = [NSArray arrayWithObjects: @"one", @"two", @"three", nil]; 

NSDictionary *dict - [NSDictionary dictionaryWithObjectsAndKeys: 
@"value 1", @"key 1", 
@"value 2", @"key 2", 
@"value 3", @"key 3", 
It 

上 上面 写 法 比较 见长 ， 而 且 需 要 以 Nil 结尾。 虽说 这 不 一 定 是 坏事 ,但 很 多 人 容易 志 记 写 nil， 而 且 几 平 每 个 开 友 者 都 曾 遇 到 过 这 个 问题 。 另 外 ， 声 明 字 典 的 时 候 ， 必 
须 先 写 value ( 值 ) ， 再 写 key ( 键 ) 。 这 与 大 部 分 人 的 认 知 相反 ， 虽 然 dictionaryWithObjectsAndKeys 这 个 方法 名 已 经 表达 了 正确 的 顺序 ， 但 很 多 人 还 是 想 先 写 


key, 5value, 


容器 字面 量 引 入 了 一 种 简单 的 新 写法 ， 从 而 解决 了 上 面 的 两 个 问题 。 下 面 代 码 所 声明 的 数组 和 字典 ， 其 内 容 与 前 面 代码 相同 : 


NSArray *array = @[@"one", @"two", G"three"]; 
NSDictionary *dict = @{ 

G"key 1":G"value 1", 

@"key 2":G"value 2", 

@"key 3":@"value 3" 


}; 


数组 字面 量 的 左右 两 侧 带 有 方 括号 ， 括 号 里 面 是 一 串 由 逗号 所 分 隔 的 元 素 。 字 上 典 是 由 花 括号 括 起 来 的 一 份 询 表 ， 其 中 的 键 值 对 以 逗号 隔 开 ， 键 和 值 之 间 用 冒号 
联 。 定 义 数 组 和 字典 时 ， 不 需要 在 结尾 加 上 mil。 键 值 对 的 书写 顺序 也 更 为 合理 了 ， 现 在 是 先 写 键 后 写 值 ， 而 不 是 像 原来 那样 先 写 值 后 写 键 。 


这 两 个 表达 式 求 值 乙 后 的 结果 ， 与 通过 传统 方式 所 声明 的 两 条 语句 相同 。 采 用 这 种 写法 时 ， 仍 然 需要 遵守 标准 的 容器 规则 : 
. 不 要 添加 值 为 nil 的 键 或 值 。 
C 每 个 元 素 都 必须 是 对 象 指 针 。 


+ 键 必 须 遵 循 。 


AA 通过 下 标 来 访问 元 素 
Clang 采 用 标准 的 取 下 标 操 作 ， 以 方 括号 来 访问 容器 中 的 元 素 。 换 句 话说 ， 开 发 者 可 以 像 使 用 C 语 言 数组 那样 来 使 用 NSArray。NSDictionary 也 可 以 按照 类 似 方 式 
访问 ， 只 不 过 下 标 是 键 而 不 是 数字 。 下 面 两 行 代码 用 来 访问 前 一 节 所 定义 的 数组 和 字典 : 


NSLog(@"%@", array[1]); // @"two" 
NSLog(@"%@", dictionary[G"key 2"]); // @"value 2" 


这 种 写法 并 不 是 只 能 用 来 查询 值 。 我 们 也 可 以 用 这 种 新 的 写法 给 可 变 的 实例 赋值 。 下 面 是 两 条 采用 新 式 下 标 写 法 的 简单 赋值 语句 : 


mutableArray[0] = @"first!"; 
mutableDictionary[@"some key"] = &"new value"; 


开发 者 仍然 需要 注意 下 标 是 否 越界 。 如 果 在 读 取 或 写 入 数组 元 素 时 ， 采 用 越界 的 下 标 来 操作 ， 那 么 程序 会 扫 出 异常 。 

另外 还 有 个 好 处 是 ， 我 们 可 以 在 自 定 义 的 类 上 面 实 现 几 个 关键 方法 ， 从 而 令 其 支持 下 标 操 作 。 如 果 想 通过 下 标 来 访问 自 定义 类 中 的 元 素 ， 那 么 可 以 考虑 实现 下 列 
方法 中 的 一 个 或 几 个 : 

-- (id) objectAtIndexedSubscript: anIndex 

:- (void) setObject: newValue atIndexedSubscript: anIndex 

:- (id) objectForKeyedSubscript: aKey 


:- (void) setObject: newValue forKeyedSubsctipt: aKey 


你 可 以 决定 是 像 数 组 那样 以 数字 作为 下 标 按照 顺序 来 访问 ， 还 是 像 字 典 那 样 以 键 作为 下 标 按 照 天 键 字 来 访问 ， 另 外 ， 还 可 以 决定 是 否 能 够 通过 下 标 来 修改 元 素 的 
值 。 我 们 只 需 实现 想 要 支持 的 方法 就 可 以 了 ， 剩 下 的 事情 由 编译 器 完成 。 


A.5 ”功能 测试 


最 后 要 说 的 是 ， 开 发 者 可 以 编写 依赖 于 某 种 特性 的 代码 。 使 用 Clang 的 _has feature 来 测试 当前 编译 器 是 否 支 持 某 种 字面 量 写法 。 这 些 功 能 测试 可 以 判断 出 编译 器 
是 否 支 持 数 组 字面 量 (objc array literals) 、 字 上 典 字 面 量 (objc dictionary literals) 、 对 象 的 取 下 标 操作 (objc subscripting) 、 数 值 字面 量 (objc bool) 及 装 箱 


f 
表达 式 (objc boxed expressions) : 


Hif has feature(objc array literals) 
PU aa 

#else 
HE s 

#endif 


